Articles on: Import/Export/Update Your Store Data

Import/Update Products

Download import template for Products

In this article:
Required Fields
Available Columns : The fields that can be imported to your store
Key notes:
How to import/update product with variants
Import/Update Product Metafields/ Variant Metafields

Required Fields


Make sure to include these columns in your upload file. Otherwise, you can't proceed to the next step properly.
SKU
Quantity
Price
Name

Available Columns


Basic Columns


ColumnDescriptionAccepted ValueExample Value
SKUSKU (Stock Keeping Unit) is a unique identifier used to track and manage inventory for individual product variants. It’s crucial for inventory management and order processing.Stringred-skirt-m
Parent-SKUThe Parent SKU is a unique identifier assigned to the main product, which groups together its variants (e.g., different sizes, colors, or styles). It helps organize and manage product variations efficiently.Stringred-skirt
QuantityThe number of units of a particular product available for sale in a store, used to manage inventory and track stock levels for order fulfillment.Numeric2
PriceThe price of the Variant item in the currency, which you have set for your Store.Numeric120
NameTitle of the ProductTextRed Skirt
DescriptionThe detailed information about a product that helps customers understand its features, benefits, and specifications. It typically includes product features, dimensions, materials, usage instructions, and any other relevant details that provide context to the item being sold.TextThis premium cotton t-shirt is soft, breathable, and perfect for everyday wear
BrandThe brand name of the itemTextNike
TagsTags enable you to add extra attributes or "properties" to your product, which can be used for filtering and displaying additional information about the product in the store.Comma-separated textT-shirt, Cotton, Casual, Unisex
ConditionThe Condition field indicates the state of the product, such as new, used, or refurbished. This information helps customers understand the product's quality and can influence purchasing decisions.TextNew
Condition_noteThe Condition Note field provides additional details about the product's condition, such as minor defects, refurbishing details, or special notes for buyers. It helps set accurate customer expectations.TextOpen box item with minor scratches but fully functional
MrspThe Manufacturer’s Suggested Retail Price (MSRP) represents the recommended selling price set by the manufacturer. It is often used for comparison against the actual selling price to show discounts or savings.Numeric49.99
seo_urlThe SEO URL is the search-engine-friendly web address of the product page. It helps improve search visibility and makes it easier for customers to find the product online.Alphanumeric text with hyphensclassic-cotton-tshirt
manufacturerThe Manufacturer field specifies the company or entity that produces the product. It helps categorize products and provides transparency about the product's origin.TextNike
costThe cost of goods sold (COGS) — used for profit margin calculations and reporting.numberic2.9$
product_type
product_id
attributesContains additional product characteristics presented as key-value pairs. These details help describe features like color, material, or style, enhancing product filtering, searchability, and overall catalog organization.TextColor: Blue; Material: Cotton; Sleeve: Short
categoriesOrganizes products into groups based on characteristics such as type, style, or target audience. It enhances product navigation and filtering, making it easier for customers to discover relevant items.Comma-separated textClothing, Men's, T-Shirts
statusThe publication or visibility status of a productTextdepend on target platform


Inventory/Variants


ColumnDescriptionAccepted ValueExample Value
heightSpecifies the vertical dimension of a product, typically used for shipping, packaging, and display purposes. It is usually measured in inches or centimetersNumeric12.5
lengthSpecifies the longest dimension of a product, commonly used for shipping, packaging, and display purposes. It is typically measured in inches or centimeters.Numeric25.0
widthSpecifies the horizontal dimension of a product, typically used for shipping, packaging, and display purposes. It is usually measured in inches or centimeters.Numeric15.0
dimension_unitsSpecifies the unit of measurement used for product dimensions (length, width, height).Textcm
weightThe Weight field specifies the mass of a product, commonly used for shipping calculations, inventory management, and product descriptions.Numeric2.5
weight_unitsSpecifies the unit of measurement used for product weight. Common units include grams (g), kilograms (kg), ounces (oz), and pounds (lb).Textkg
variation_1Defines the first attribute that differentiates product variants, such as size, color, or material. It helps organize and manage product variations efficiently.TextColor - Red
variation_2Defines the second attribute used to differentiate product variants, such as an alternative size, color, or style option. It allows for additional customization and organization of product variations.TextSize - Medium
variation_3Defines the third attribute used to differentiate product variants, such as additional options like material, pattern, or design details. It provides further customization and organization for products with multiple variant attributes.TextPattern - Striped
manage_stockDetermines whether the store tracks inventory levels for a product or variant. When enabled, Shopify keeps track of how many items are in stock and can automatically prevent sales of out-of-stock itemBooleanYes, No


Media


ColumnDescriptionAccepted ValueExample Value
product_image_1Holds the primary visual representation of the product. This image is typically used as the featured image on product listings and detail pages, providing customers with a clear view of the product.URLhttps://example.com/images/product1.jpg
product_image_2Holds an additional visual representation of the product, offering customers different angles or more detailed views beyond the main image.URL__https://example.com/images/product1.jpg__
product_image_3
product_image_4
product_image_5


Custom Columns


ColumnDescriptionAccepted ValueExample Value
mpnThe MPN is a unique identifier assigned by the manufacturer to distinguish a specific product. It is commonly used for inventory management, search optimization, and product verificationAlphanumeric textABC12345
upcThe UPC is a globally recognized barcode used to uniquely identify a product. It helps with inventory management, product tracking, and online marketplace listingsNumeric12345678905
eanEuropean Article Number: The EAN is a globally recognized barcode used to uniquely identify a product, similar to the UPC but primarily used outside North America. It helps with inventory management and product tracking.Numeric4006381333931
isbnInternational Standard Book Number: The ISBN is a unique numeric identifier assigned to books and other published media. It helps with inventory tracking, cataloging, and online searches.Numeric4006381333931
gtinThe GTIN is a globally recognized identifier used to uniquely distinguish products. It includes UPC, EAN, and ISBN codes and is essential for inventory management and online marketplace listings.Numeric9506000134324
gcidGlobal Catalog Identifier: The GCID is a unique identifier assigned by Amazon to products that do not have a GTIN (UPC, EAN, or ISBN). It is mainly used for brand-registered sellers on Amazon to track and manage products.Alphanumeric textXH29D8KJLQ45
asinAmazon Standard Identification Number: The ASIN is a unique 10-character alphanumeric identifier assigned by Amazon to products listed in its marketplace. It helps track and manage products in the Amazon catalog.Alphanumeric textB08N5WRWNW
epideBay Product Identifier: The EPID is a unique identifier assigned by eBay to products in its catalog. It helps sellers list items accurately by matching them with existing product details.Numeric123456789012
Metafield: namespace.keyYou can import and update metafields by adding columns that follow this naming pattern in your import/update file. If your columns are formatted correctly, BulkFlow will automatically map them as metafields during the Field Mapping step. Alternatively, you can manually assign them by selecting Add Metafield. Please note that BulkFlow does not create new metafield definitions if they don't already exist in your store. In such cases, the metafield will be imported as an unstructured metafield using the namespace.key specified in your file.StringMetafield: custom.scent
Variant Metafield: namespace.keyYou can import and update variant metafields by adding columns that follow this naming pattern in your import/update file. If your columns are formatted correctly, BulkFlow will automatically map them as variant metafields during the Field Mapping step. Alternatively, you can manually assign them by selecting Add Variant Metafield. Please note that BulkFlow does not create new variant metafield definitions if they don't already exist in your store. In such cases, the metafield will be imported as an unstructured variant metafield using the namespace.key specified in your file.StringVariant Metafield: custom.instruction


Key notes


How to import/update product with variants


You can add options to your product using the variation_(n) columns.
In the row of the parent product, specify the option name (e.g., Color, Material).
In the rows of the child products, enter the option values that correspond to each variant.
Make sure to fill in the attributes column with the exact option names you've configured in the variation_(n) columns.
For example, if the parent product's variation rows include Color, Material, and Size, then its attributes column must list:
Color  
Material  
Size


In the attributes column of each child (variant) row, include the corresponding option values in the format:

Color: Red  
Material: Cotton  
Size: L


Please note: The values in your attributes column must be formatted exactly as shown in the example above. And if you leave this column blank when importing or updating product variants, an error will occur.

Import/Update Product Metafields/ Variant Metafields


In your import/update file, include metafield columns using the format:
`Metafield: namespace.key`
BulkFlow will recognize this as a metafield and automatically map it during the Field Mapping step.
Alternatively, you can name the column freely and manually map it later in the Field Mapping step.

Updated on: 30/05/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!