Skip to main content

Upload Swatches in Bulk via CSV for Shopify Variants

This guide to help you to bulk upload swatches for multiple product options via CSV.

Updated over 9 months ago

Leverage this functionality to efficiently update swatch images in bulk for all product options or synchronize swatches with another store. Let's explore the effective steps to achieve this.

Step 1: Download a sample CSV file

  • To download the sample CSV, navigate to the app dashboard and go to the Shopify variants section.

  • Click on Bulk update swatches dropdown and click Import file

  • Click on Download Sample CSV

You can also download the file from here: Sample CSV file.


Step 2: Formatting the product CSV file

Your Bulk Update Swatch CSV file should meet the following criteria:

  • The first line of your product CSV file must contain the column headers, as shown in the sample file above

  • If you use Excel to edit your CSV, please remember to export the file in CSV format

Step 3: Importing CSV to upload swatches

  • Navigate to the Swatch King dashboard

  • Click on the Shopify variants section in the side navigation.

  • Click on Bulk update swatches dropdown

  • Click on the Import file button and upload the CSV file

  • Click Add file, then select the CSV file you want to import.

After uploading your CSV file, you will receive a confirmation email from StarApps Studio at the email account you used to set up your Shopify store. This email will contain details about how many swatches were updated and any errors if there are any.

Understanding CSV file template (Click to expand)

Now that you have downloaded the template, you will find the following fields. Add relevant details according to your requirements.

  • Option Name is the label of the options created on Shopify for products. The App categorizes the products based on their option name, for example, Color, Style, and Material. This is not a mandatory field.

  • Option Value represents the variant name for which you intend to upload swatches.

    • Example 1- If you offer a Black variant under both Color and Material options and want unique images for each Black variant, include the Option Name column in the sheet.

    • Example 2- Skipping the Option Name column means that, for a Black variant under both Color and Material options, the images will be updated together. This simplifies the process when you want the same images for a variant across multiple options.

  • Swatch color code / Image URL To upload swatch images for your variants, you have two options: Hex Code or URL.

    • Hex Code: Simply enter the desired color's Hex code into the provided field.

    • Uploading via URL: For URL-based uploads, ensure the URL is publicly accessible.


In case you want to update the colours regardless of the option name, use the same format and leave the Option Name column blank. This will update the colour for the option values in all the options. Useful when you have the same color across all multiple options.

Note: If you face any issues while importing the file, please don't hesitate to contact our support.




Did this answer your question?