Creating Product Groups via CSV

Swatch King offers multiple methods to create/update product groups:

This guide will focus on creating/updating Product Groups using CSV.

Step 1: Download a sample CSV file

The CSV to create groups has a simple specific format. To obtain the sample CSV format file from the App Dashboard, follow these steps:

On the app dashboard, go to the Product Groups section.
Select Import file in Bulk update groups dropdown.
Click on Download Sample CSV
- Note: If you already have groups in your store and want to bulk update their properties, click Export File.

You can also download the file from here sample product CSV file.

Step 2: Formatting the groups CSV file

The first line of your groups 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

If you wish to understand the CSV template in detail, click here.

Step 3: Importing CSV to create groups

Navigate to the Swatch King dashboard
Select Import File in Bulk update groups dropdown.
Click on the Add file button and then select the CSV file you want to import.
You will see the alert about the groups that will be created or if the file has any formatting errors. In case of errors, please correct and re-iterate the process.
Click Import button to start the import process.

After this, 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 groups were created and any errors if there are any. You can also add any other email where you would like to receive the reports.

New to CSV, please use this guide - Understanding CSV
Need to know how to fetch product handle? Learn here - Export Products

Note: A file size of 2MB can be imported at a time that is equivalent to 20,000 products; if you wish to upload bigger files, please reach out to our support through chat, and they will assist you

Learn to apply same swatch image across all groups that have same option name (say Color) and option value (say Black) - View Guide

Understanding CSV file template (Click to expand)

Let's understand all the details that should be added to a CSV file to create a group.

Group Name is a unique identifier the app uses to organize product groups; assign the same Group Name to products you want in one group. Please note this 'Group Name' is only visible on the app dashboard, and shoppers won't see it.
Product Handle in Shopify is a unique identifier for each product. It's a URL-safe version of the product name. For example, if your product URL is https://store.com/products/blue-t-shirt, the handle is blue-t-shirt
- To fetch product handles for your products, simply export the product details from your store.
Product Groups function similarly to Shopify Variants. Like any option created on Shopify, product groups also have an Option Name, which can be such as Color, Material, or Available in, etc

Option Value is the characteristics of each product (like Color: Red, Pink or Material: Cotton, Denim) that you want your customers to see.
Product Style Name and Collection Style Name determine how you'd like to visually present your groups. The App's Design Library provides many options, allowing you to select the display style that suits your preferences. These design styles are highly customizable. and can be tailored to fit your requirements. Head to your Product page styles or Collection page styles to explore more

In the sample sheet below, you see 'T-shirt' displayed as a Square Swatch on the product page and as a Circular Swatch on the collection page. If you do not want to display a particular option on the collection page, add "Do not show" or "Hidden" in the Collection Style Name.
Product Page Swatch Source /Collection Page Swatch Source helps you decide whether you want to use Variant Images, allowing Swatch King to use the product's image as the swatch, or choose Color/Custom Image for custom images or hex colors. You can have differently image source for the Product and Collection Pages. In the example below, for Color ;Product Page Swatch Source is First Variant Image, and Collection Page Swatch Source is Custom Swatch
Swatch color code / Image URL allows you to upload swatch images for your variants, you have two options: Hex Code or URL.
- Hex Code: Enter the desired color's Hex code into the provided field.
- Uploading via URL: For URL-based uploads, ensure the URL is publicly accessible.

Creating Product Groups via App Dashboard

Creating Product Groups via Product Tags

Upload Swatches in Bulk via CSV for Shopify Variants

Creating Product Groups via App Dashboard

Creating Product Groups via CSV