Skip to main content

[Swatch King] Collection page settings

This document describes the elements and their functions in the "Collection page settings" page of the Swatch King app.

Swatch King allows you to display options on the grid product cards on the collections, search, carousels and other pages. On Collection page settings page, you can assign styles to options for those grid product cards. You can select the same or a different style for mobile and desktop. You can also choose not to show the option on the collections page.

The Collection page settings has four columns as follows:

Option name

This column lists all the unique options that you have added in the products in your store. Options are treated as case sensitive. For example, if you have added option name "Color" in one product and "color" in other, then it will be counted as two separate options. You can also see the number of products in which the option name is added by clicking on the text "in x products" under each option name.

Desktop option style

In this column, you can assign styles to each option for the desktop view. Click on the dropdown next to each option, and you can select styles in the "Select option style" modal that opens.

The modal shows all the styles you have added to Customise styles the page. You will also see "Do not show" which you can select if you dont want to display the option on the collections. The styles are based on swatch, button or dropdown. If you choose swatch-based styles such as Polaroid swatch, then you can select the following four image sources in the next dropdown:

  • First variant image- Displays the first variant image as the swatch.

  • Second variant image- Displays the second variant image as the swatch.

  • Last variant image- Displays the last variant image as the swatch.

  • Color/cutsom image- Allows you to upload colours or custom images for the swatch. If selected, you will see the upload icon in the fourth column Upload swatch

Mobile option style

In this column, you can assign styles to each option for the mobile view. Click on the dropdown next to each option, and you can select styles in the "Select option style" modal that opens.

The modal shows all the styles you have added in Customise styles page. You will also see "Do not show" which you can select if you dont want to display the option on the collections. The styles are based on swatch, button or dropdown. If you choose swatch-based styles such as Polaroid swatch, then you can select the following four image sources in the next dropdown:

  • First variant image- Displays the first variant image as the swatch.

  • Second variant image- Displays the second variant image as the swatch.

  • Last variant image- Displays the last variant image as the swatch.

  • Color/cutsom image- Allows you to upload colours or custom images for the swatch. If selected, you will see the upload icon in the fourth column Upload swatch

Upload swatch

In this column, you can upload a colour or custom image if you have selected a swatch-based style for options. The upload button will be displayed if you have chosen "Colour/custom" image for the swatch source in column two or three.

Clicking on the icon will open the modal where you can add colour or a custom image for the option values. The modal lists all the unique values for the respective option with a preview of the current colour/custom image. You can view all products with option values by clicking on "x products" next to the option value.

You have the following three ways to upload colour/custom images in the modal:

Add color- Here you can select a colour from the palette or add a hex code.

Add from URL- Here, you can add a custom image URL for the option value swatch.

Add file- You can upload an image file from your device.

  • The image file must be a public file URL under 512kb.

  • Only PNG, JPG and JPEG formats are allowed.

  • If you have uploaded a colour/custom image in the product page settings, it will also be populated in the collection page settings. You do not need to upload again.

Bulk operations using the toolbar and CSV

Swatch King provides you with the ability to manage styles for the options in bulk via the toolbar and CSV import/export functions.

Manage styles for the options in bulk via the toolbar.

You can search for specific options in the search bar and select multiple options by clicking on the checkbox before the option name. After choosing various options, you can change the following:

  • Desktop option style

  • Desktop option swatch

  • Mobile option style

  • Mobile option swatch

Manage styles for the options in bulk via the CSV import/export.

Swatch King allows you to update the styles of the option for mobile or desktop via CSV. For this, you can click on Bulk update options in the top right corner and then click on Export file. You can export the file to your registered email and any other email.

The CSV has the following 6 columns.

  • Option Name: This field contains the option name, as in the product.

  • Collection Page Style Name - Desktop: This field contains style name for desktop view. Add "Hidden" if you don't want to show the option on collections.

  • Collection Page Swatch Source - Desktop[applicable for swatch-based styles]: It can have values, Custom Swatch, First variant image, Second variant image and Last variant image

  • Collection Page Style Name - Mobile: This field contains the style name for the mobile view. Add "Hidden" if you don't want to show the option on collections.

  • Collection Page Swatch Source - Mobile[applicable for swatch-based styles]: It can have values, Custom Swatch, First variant image, Second variant image and Last variant image

  • Manual Option Selection: It has two values, True or False. If you want to force option selection, then set it to True; otherwise, set it to False.

Once you have added the styles and swatch source, you can import the file by clicking on Import file. Here's an instance of how the CSV looks:

Bulk update swatches for options via CSV import/export.

Swatch King allows you to upload the colour or custom images for the option values via CSV. For this, you can click on Bulk update swatches in the top right corner and then click on Export file. You can export the file to your registered email and any other email.

The CSV has the following 3 columns.

  • Option Name: The option for which the colour/custom you are uploading.

  • Option Value: Option value for which you are uploading color/custom image.

  • Swatch Color Code / Image URL[optional]: Contains the hex code of the color or public URL of an image file under 512kb.

Once you have added the option name, option value and swatch color or image, you can import the file by clicking on Import file. Here's an instance of how the CSV looks:

Did this answer your question?