Product Import Guide

Home About How It Works FAQ Contact

Product Import Guide

Import products in bulk using CSV files. Choose a template that matches your needs.

Quick Tips

We mostly follow Shopify's Export format for compatibility.
Handle groups rows into one product. Same handle = same product with variants.
SKU must be unique for each variant row.
Images support comma-separated URLs or multiple columns.
Column names are case-insensitive. "Title" = "title" = "TITLE".

Download Templates

Each template includes example data. Choose based on your product structure.

Simple Products (No Variants)

Basic

Use this when each product has no variations. One row = one product.

Download

Features

One row per product
No size or color variations
Fastest to prepare

Best For

Accessories, books, single-style items

Products With One Variant Type (Size)

Intermediate

Use this when products vary by one attribute like size. Each size is a separate row.

Download

Features

Multiple sizes per product
Same Product ID groups sizes together
Separate stock per size

Best For

T-shirts, shoes, pants

Products With One Variant Type and multiple image per variant (Color)

Intermediate

Use this when products vary by one attribute like color. Each variant can have multiple images.

Download

Features

Multiple colors per product
Different images per color
Supports variant-level images

Best For

Bags, apparel, accessories with color choices

Products With Multiple Variant Types (Color + Size)

Advanced

Use this when products vary by both color and size. Most flexible template.

Download

Features

Color × Size combinations
Supports all product fields
Best for complex catalogs

Best For

Polo shirts, jackets, dresses

How Variants Work

Products with multiple sizes/colors use multiple rows with the same Handle and different SKU to separate variants of the same product. They should also include option columns to specify the variant attributes.

Handle	Title	Option1 Name	Option1 Value	SKU	Price
my-tshirt	My T-Shirt	Size	S	TS-S	999
my-tshirt			M	TS-M	999
my-tshirt			L	TS-L	999

↑ This creates 1 product with 3 size variants (S, M, L).

Images

Image (Common Images)

Added to ALL variants. Great for lifestyle/model shots.

Variant Image (Variant-Specific)

Shown first for that specific variant. Use for color-specific product shots.

Multiple Images

To add multiple images, you can either use multiple rows (shopify's way) or,
Use comma-separated URLs in one column: https://img1.jpg, https://img2.jpg, https://img3.jpg

Maximum 15 images per variant. Extra images will be ignored.

Import Settings

After selecting your CSV file, the settings panel will open. Configure these options before processing.

Shop & Brand

Select the default shop and brand for all products. These will be applied to products that don't have a brand specified in the CSV.

You can also specify brand per product in the CSV using the Brand column with the brand's slug.

Image URL Validation

When enabled, the system validates each image URL to ensure it's accessible. This helps catch broken or invalid image links before import but may slow down processing for large catalogs.

If disabled, images are imported as-is without validation. Any invalid URLs may result in broken images on your product pages.

Category Mapping

Configure how product categories from your CSV are mapped to the platform's category system.

Default Tax Category

Select a tax category that will be applied to all products. Each tax category includes a default HS Code and GST slab for tax calculations.

Default Categories (Subcategories)

These are the display categories used for the category tree on customer-facing pages. At least one category is required for each product.

Tip: For easier handling, import products of the same category together. This way you can set default categories once and they'll apply to all products in that batch.

Custom Category Mapping

If your CSV has a Category or Type column, the system extracts all unique values from it. You can then map each category value to a specific tax category and subcategories.

For example, if your CSV has "Apparel > T-Shirts" in the Category column, you can map it to the "Clothing" tax category with "Men's T-Shirts" and "Casual Wear" subcategories.

Other Settings

Weight Unit: Specify if weights in your CSV are in grams or kilograms.
Default Tags: Tags that will be added to all imported products.
Size Chart & Guides: Upload default size chart and guide images for all products.

Column name Reference

Column names are flexible and case-insensitive. For extensive compatibility with other platforms (like shopify) exports, we also support some alternative column names (e.g., "Body (HTML)" works as "Description").

Column Name	Required	Description	Alts
Handle	Yes	Unique identifier (slug). Same handle = same product. Also used as url-slug	url handle, product handle, slug
Code	No	Internal product code. Used for your reference.	product code
Title	Yes	Product name. Only needed on first row.	product name
Description	Yes	Full product description. Supports HTML. (Either Description or Short Description is required)	body (html)
Short Description	No	Brief product summary (plain text).	-
Seo Title	No	Meta title for SEO. If blank, uses Title.	meta title
Seo Description	No	Meta description for SEO. If blank, uses Short Description or Description.	meta description
Price	Yes	Sale price (what customer pays).	variant price
Compare At Price	No	Original price (for showing discount). If left blank, uses Price (means no discount).	variant compare at price
SKU	Yes	Unique variant identifier. Each variant needs unique SKU.	variant sku
Inventory Quantity	No	Stock count. Defaults to 0.	inventory qty, stock, variant inventory qty, variant inventory quantity
Weight	Yes	Product weight. Supports: 100g, 1.5kg, 500	variant weight, variant grams
Dimensions	Yes	L×W×H format. Example: 30x20x5 or 30cm x 20cm x 5cm	dimension, variant dimension, variant dimensions, dimension (product.metafields.custom.dimension)
Image	Yes	Common product images (added to all variants). At least one image is required (either Image or Variant Image).	images, image src, image url
Variant Image	No	Variant-specific image (shown first for that variant).	variant images, variant image src, variant image url
Option1 Name	No	First option name (e.g., "Color", "Size"). Required if using options.	-
Option1 Value	No	First option value (e.g., "Red", "M"). Required if using options.	-
Option2 Name	No	Second option name.	-
Option2 Value	No	Second option value.	-
Option3 Name	No	Third option name.	-
Option3 Value	No	Third option value.	-
Category	Yes	Product category path. Should be mapped in settings.	product category, type
Tags	No	Comma-separated tags.	product tags
Brand	No	Brand slug (must exist in your shop).	-
Gender	No	Target gender. Allowed values: male, female, unisex, kids, boy, girl, others	target gender
Status	No	active/sale or draft. Defaults to active.	-
Size Chart	No	URL to size chart image for this product.	sizechart, size chart url
Size Guides	No	URL to size guides images for this product.	sizeguides, size guides url
HS Code	No	Hs Code of the product. (if blank, gets from the mapped category)	hsn code
GST	No	GST % for India. (if blank, gets from the mapped category)	gst india, gst rate, gst %, gst percentage

Need help? Contact Support.