[Swatch King] Product page settings

Product page settings is where you decide how each of your product options appears on your product pages.

[IMAGE: Polaroid swatch and button style on the product page]

How it fits together

Setting up an option takes up to three decisions, and the later ones only appear when they apply:

Pick a style — swatch, button or dropdown
If you picked a swatch style, pick a swatch source — what the swatch actually shows
If you picked Color/custom image as the source, upload the colors or images

A button or dropdown style stops at step 1. That is why the swatch source dropdown and the upload icon appear for some options and not others.

The page has four columns.

Column	What it does
Option name	Every unique option in your store
Desktop option style	The style shown on desktop
Mobile option style	The style shown on mobile
Upload swatch	Where you add colors and custom images

Option name

Lists every unique option name across your products — Color, Size, Material and so on.

Options are case sensitive. If one product uses "Color" and another uses "color", they count as two separate options and each needs its own style.

Click in x products under any option name to see which products have the option name.

Desktop and Mobile option style

These two columns work identically — you set them separately so you can use one style on desktop and a different one on mobile. A compact style often works better on a small screen.

Click the dropdown next to an option to open the Select option style modal.

The modal shows every style in your Customize styles library. Your store can hold up to 20 saved styles — add, rename and adjust them there, then assign them here.

Swatch sources

If you choose a swatch-based style such as Polaroid swatch, a second dropdown appears for the swatch source:

Source	What the swatch shows
First variant image	The variant's first image
Second variant image	The variant's second image
Last variant image	The variant's last image
Color/custom image	A color or image you upload yourself. Choosing this adds an upload icon in the Upload swatch column

Button and dropdown styles have no swatch source — there is no image to show.

Upload swatch

The upload icon appears for any option where you set the swatch source to Color/custom image, on desktop or mobile.

Clicking it opens a modal listing every unique value for that option, with a preview of its current color or image. Click x products beside a value to see which products use it.

[IMAGE: upload color or custom image modal]

Three ways to set a swatch:

Add color — pick from the palette or enter a hex code
Add from URL — point to an image already hosted online
Add file — upload an image from your device

Image requirements

PNG, JPG or JPEG only
Under 512kb
If you are adding from a URL, it must be publicly accessible

Uploads are shared with your collection pages. A color or image you set here also applies on the Collection page settings page — you do not need to upload it twice.

Bulk operations

For stores with a lot of options, you can work in bulk from the toolbar or by CSV.

Assign styles to several options at once, from the toolbar

Search for options in the search bar, then tick the checkbox beside each one you want to change. With options selected you can set:

Desktop option style
Desktop option swatch
Mobile option style
Mobile option swatch

[IMAGE: GIF of selecting styles for multiple options]

Assign styles in bulk by CSV

Click Bulk update options in the top right, then Export file. You can send the export to your registered email or any other address.

The CSV has six columns:

Column	Values
Option Name	The option name exactly as it appears on your products
Product Page Style Name - Desktop	A style name from your Customize styles library
Product Page Swatch Source - Desktop	Custom Swatch, First variant image, Second variant image, or Last variant image — swatch styles only
Product Page Style Name - Mobile	As above, for mobile
Product Page Swatch Source - Mobile	As above, for mobile
Manual Option Selection	True or False. True requires the customer to choose this option before adding to cart. This is the same setting as App settings → Option selection

Fill it in, then click Import file.

Upload swatch colors and images in bulk by CSV

Upload swatch colors and images in bulk by CSV

Click Bulk update swatches in the top right, then Export file.

The CSV has three columns:

Column	Values
Option Name	The option you are uploading swatches for
Option Value	The specific value — Red, Large, Cotton
Swatch Color Code / Image URL	A hex code, or a public URL to an image under 512kb