The Product ID is a unique numeric identifier automatically generated by Shopify for each product. It is used internally by Shopify to reference and manage product records.
This ID can be used when referencing a product in API requests or when matching products between multiple exports.
The Product Title is the main name of the product as it appears on your storefront and admin. It is used to describe the product to customers and is displayed across search, collections, and product pages.
The Product Description contains the full text that appears on the product page under the product title. This field is typically used to provide detailed information about the product — such as features, materials, usage instructions, or brand story.
The Product Status determines the visibility of the product in your Shopify store. It controls whether a product is a draft, active (published), or archived.
Use this field to manage product availability during import/export operations — for example, you can bulk-publish products or set them as drafts while editing.
The Theme Template field defines which Liquid template will be used to render the product page on your storefront.
It allows you to assign a custom layout — for example, a unique landing page style, or different layouts for seasonal collections.
The Product URL is the full link to the product page on your online store. It is constructed automatically based on your store’s domain and the product’s handle (a unique URL-friendly identifier for each product).
This field is read-only and typically used for reference during export.
The Remove Current Tags checkbox allows you to clear all existing tags from a product before applying new ones during import.
When enabled, the app will remove any tags currently assigned to the product in Shopify, and replace them with the new tags from your import file (if any).
The Tags field contains one or more keywords used to label and organize products in Shopify. Tags are useful for filtering products in the admin, building automated collections, and enhancing store search.
Tags can be imported, exported, and updated in bulk. You can also choose whether to add to existing tags or replace them completely using the Remove Current Tags checkbox.
The Date Created field records the exact date and time when a product was originally added to your Shopify store. It is a read-only field provided by Shopify.
The Date Updated field shows the last time the product was modified in Shopify — whether through the admin interface, an app, or API. It reflects any change to the product, including edits to title, description, images, variants, pricing, status, etc.
This field is automatically updated by Shopify and is export-only.
The Is Gift Card field identifies whether the product is a Shopify gift card product. Gift cards function differently from regular products — they don’t have physical inventory, cannot be shipped, and are used as store credit.
This field is read-only and assigned automatically when a gift card product is created in Shopify (usually by enabling the gift card feature or via Shopify’s native product generator).
The Remove Current Product Images checkbox lets you delete existing images only for the products included in your import file, before applying new images.
This ensures you can fully replace outdated or incorrect images on a per-product basis, without affecting the rest of your catalog.
The Import Just for Products Without Images checkbox ensures that new images are only added to products that currently have no images in Shopify.
When this option is enabled, your app will skip importing images for products that already contain at least one image, avoiding duplication or accidental overwriting.
This advanced option downloads product images from your file and temporarily stores them on our app server, so they can be safely and reliably uploaded to Shopify during import.
🛠️ Key Features:
• Ensures stable image delivery to Shopify even if original URLs are slow, expiring, or protected.
• Automatically converts images to WebP format for optimal Shopify compatibility.
• Automatically resizes images larger than 25 megapixels (Shopify’s maximum limit) to 25MP.
💼 Available on:
• Enterprise Plan only
✅ When to Use:
• When your file contains image URLs that:
• Slow or rate-limited external servers.
• Are hosted on unreliable or slow servers.
❗ Important:
• This feature is only used during image import.
• It does not store images permanently — they are removed after import completes.
The Images URLs field contains one or more links to product images that should be imported into Shopify. These links must point to publicly accessible image files hosted online.
You can provide multiple images for each product using either of the following formats:
1. Multiple columns (e.g. Images URLs #1, Images URLs #2, …)
2. A single column with image URLs separated by commas
The Images Alt Text field allows you to define alternative (alt) text for each product image. Alt text improves accessibility for screen readers and boosts SEO by describing the image content to search engines. Alt text is imported together with images — it must be paired with the corresponding image URLs in the same row.
Returns the URL of the main (featured) product image — the image displayed first on the product page.
Exports the alt text (alternative text) of the product’s main (cover) image.
The Media Content Type field specifies the type of media being attached to the product. Shopify supports three types of media:
• Image – Standard product image (JPG, PNG, WebP, etc.)
• External Video – YouTube or Vimeo video URLs
• 3D Model – .glb files used for 3D product previews
This field helps Shopify interpret how to display or render the linked media.
Publishes the product to one or more available sales channels in your store (e.g. Online Store, POS, Inbox).
Removes the product from selected sales channels.
Adds the product to selected Shopify Markets (e.g. North America, Europe).
Removes the product from one or more selected markets.
The Price field represents the selling price of the product (or variant) in your Shopify store. This is the amount customers will pay at checkout unless discounts apply.
The Compare at Price is used to show the original price of the product before a discount.
If this value is higher than the product’s actual price, Shopify will display it as a strike-through price — signaling a discount or sale.
The Cost per Item field stores the actual cost of the product or variant for the merchant — i.e., what it costs you to purchase, manufacture, or produce the item.
This field is not shown to customers and is used for calculating profit margins and analytics inside Shopify.
Represents the actual quantity of the product (e.g., 1.5, 750, etc.) — used to calculate the unit price.
Used together with:
• Unit for Total Measurement (e.g., kg, L)
• Base Measurement (e.g., 1, 100)
• Unit for Base Measurement (same unit as above)
Specifies the unit used in the Total Measurement value — e.g., g, kg, ml, l.
• Must match one of Shopify’s accepted units
• Should match Unit for Base Measurement
Defines the reference amount for calculating the unit price (e.g., per 1 kg, per 100 g).
• Must be 1, 100, or 1000 depending on the unit
• Used with Unit for Base Measurement
Specifies the unit type used for the Base Measurement value.
• Must match the Unit for Total Measurement
• Used for displaying unit price (e.g., €/kg)
This setting determines whether taxes should be applied to the product or variant during checkout.
It allows merchants to enable or disable tax calculation per product depending on local regulations or product type (e.g. digital goods, tax-exempt items, etc.).
The SKU is a unique code assigned to a product or variant for inventory tracking, fulfillment, and integration with external systems (like ERPs, warehouses, or POS systems).
This field is optional in Shopify, but highly recommended for organizing and syncing product data.
The Barcode field is used to store the unique machine-readable identifier for a product or variant — such as:
• UPC – Universal Product Code
• EAN – European Article Number
• ISBN – International Standard Book Number
• GTIN – Global Trade Item Number
This field helps you integrate with POS systems, inventory scanners, and Google Shopping (where GTINs are often required).
The Continue Selling When Out of Stock field controls whether customers can still place orders after the inventory level reaches zero.
This is useful for pre-orders, made-to-order products, or when inventory is managed externally.
The Quantity Import Method determines how inventory quantities are applied during import.
It gives you the flexibility to:
• Set stock to an exact number
• Add to the existing quantity
• Reduce from the existing quantity
The Quantity Location field lets you specify which inventory location to apply stock updates to during import.
App allows syncs the available inventory locations from the user’s Shopify store — so users can select from a dropdown instead of typing manually.
The Quantity field defines how many units of a product or variant are available in stock at a given inventory location.
Depending on the selected Quantity Import Method, this value will either replace, increase, or decrease the current inventory level.
The Available for Sale field indicates whether the product is currently buyable on the storefront and other active sales channels.
It is a read-only field and is included in exports for reference only.
The Weight field defines the physical weight of the product or variant. Shopify uses this value for shipping rate calculations, especially when using real-time carrier shipping or weight-based rules.
This field is stored per variant (or product if no variants exist) and is usually combined with a weight unit (e.g., grams, kilograms, pounds).
The Weight Unit field specifies the unit of measurement for the product or variant’s weight and must be provided alongside the Weight field during import.
This ensures Shopify correctly interprets the value (e.g., grams vs. kilograms).
The Country/Region of Origin field indicates the country where the product or variant was manufactured or assembled.
This information is used for customs forms, tax calculations, and duty assessments when selling or shipping internationally.
The HS Code (Harmonized System Code) is a standardized, internationally recognized numeric code used to classify goods for customs declarations, import/export duties, and cross-border compliance.
Each product or variant that is shipped internationally should have a valid HS Code to ensure correct handling by customs authorities.
This setting allows you to automatically delete variants that are currently in Shopify but not present in the import file for a given product.
It ensures the product has only the variants you explicitly provide in your import, which is useful for managing dynamic inventories or cleaning up obsolete variants.
The Generate Variants from Option Values checkbox allows the app to automatically create multiple product variants from option values that are separated by commas in your import file.
Instead of listing each variant on its own row, you can define all variations in a single row, and the app will split and generate variants dynamically based on the values.
The Variant Identification Key defines how the app should match or update existing variants in Shopify when importing. It tells the app what to use to uniquely identify a product variant.
Available values:
• Attributes (default): Matches variants based on option values (e.g., Color, Size).
• SKU: Matches variants by the SKU (must be unique across the product).
• Barcode: Matches variants by the Barcode (ISBN, UPC, GTIN, etc.).
• Update all variants: When this option is enabled, the app will apply the same data to all variants of the product
The Option Name defines one of the variant option types for a product (e.g., Color, Size, Material). Shopify allows up to 3 option types per product, and each product variant is identified by the combination of its option values.
Fields:
• Option name #1 → corresponds to the first variant dimension (e.g., Color)
• Option name #2 → second dimension (e.g., Size)
• Option name #3 → third dimension (e.g., Material)
Each Option Name has two settings:
• Enter manually — You can manually enter the name (Color, Size, etc.).
• Get from column — You can select a column from your file that contains the option name. This is useful if each product has dynamic or unique option names.
The Option Value corresponds to a specific choice for a given Option Name (e.g., if Option Name is Color, values could be Red, Blue, Green).
Each product variant must have one value for each Option Name it uses.
If you enable the checkbox “Generate variants from option values”, the app will:
• Automatically create variant combinations from all values
• Split the values by commas
👉 Example:
• Color = Red,Blue
• Size = S,M
➤ 4 variants will be generated: Red-S, Red-M, Blue-S, Blue-M
The Variant Image URL field lets you assign a unique image to each product variant.
This is especially useful for visually differentiating variants such as color, style, or packaging directly on the product page.
📥 Import Behavior
• Accepts a direct image URL for the variant image
• Only one image per variant is supported
• If the URL is valid and accessible, the app uploads it to Shopify and links it to the corresponding variant
The Variant Image Alt field contains the alternative (alt) text associated with each variant’s image.
Alt text is used for accessibility (screen readers) and SEO to describe the image content.
This field allows you to map variant-level metafields from your Shopify store.
App automatically syncs and fetches all available variant metafields, so you can pick from a dropdown and apply custom data per variant.
This field allows you to assign a value to a selected variant metafield during import.
It pairs directly with the selected Variant Meta Field #1, #2, etc., and should contain valid content according to that metafield’s expected format (as defined in Shopify).
This field represents the unique Shopify ID for each product variant.
It is used internally by Shopify and is available for reference purposes only.
The Page Title is the title that appears in the browser tab and search engine results for the product page. It is a key SEO element that helps improve product discoverability on search engines.
The Meta Description is a short summary that appears in search engine results below the page title. It influences click-through rate.
The Handle is the unique, URL-friendly identifier used to generate the product page’s web address in Shopify. It appears as part of the product URL, e.g.: https://yourstore.myshopify.com/products/**your-product-handle**
When enabled, this option will remove all existing collection assignments from the imported products before applying the new ones from the file.
⚠️ Important: This action only applies to the products included in the import file. Other products in the store will remain unaffected.
When enabled, this option ensures that a manual collection is created if:
• The imported collection name exists in your store, but only as an automated (smart) collection.
• Shopify doesn’t allow assigning products via import to automated collections — so this option allows you to override that limitation.
This setting determines how the app interprets the collection data from your import file. You can choose from different methods depending on how your data is structured.
🧾 Options
• Collection name - The app will assign products to collections based on a simple collection name in your file. Example: Shoes
• Collection tree - The app splits values using the selected delimiter (e.g., ->) and assigns products to all levels as separate collections.
Used to split collection paths when using the “Collection tree” import method.
🧩 Example: Men → Shoes → Boots
The app will assign the product to 3 separate collections:
• Men
• Shoes
• Boots
💡 Notes:
• Only relevant when Collection tree is selected as the import method.
• Shopify does not support nested collections, so each level is imported as a flat collection.
• You can choose from symbols like /, |, →, etc.
Use these fields to assign imported products to one or more collections.
Description:
• You can map multiple collection fields (Collections #1, #2, etc.) by clicking Add Collection.
• Each mapped column can contain:
• A single collection name, or
• A tree-like collection structure (if “Collection tree” is selected as the import method).
When enabled, this feature allows you to manually map the collection names in your import file to existing Shopify collections in your store.
Description:
• Use this when the collection names in your file do not exactly match the names in Shopify.
• You can create multiple mapping pairs (File column → Store collection) by clicking Add Collection.
• The app will assign products to the selected existing store collections, skipping automatic collection creation.
This field is for export only. It outputs a comma-separated list of collection names the product is currently associated with in the store.
Exports the IDs of all collections the product is associated with, separated by commas.
This field allows you to import, export, and translate the product vendor (brand/manufacturer).
Description:
• You can map a column from your import file to Shopify’s built-in Vendor field.
• If the value is empty during import, the vendor will not be updated.
• If the vendor already exists in the store, the product will be assigned to it.
• If the vendor does not exist, Shopify will automatically create it.
• During export, the current vendor name for each product will be included.
•During translation, vendor values can be translated using the store supported languages and app translation settings.
This field allows you to set, export, and translate the product type for each product in your store.
This field lets you assign a Shopify standard product category based on Shopify’s predefined taxonomy. It ensures better SEO, more accurate product organization, and compatibility with marketplaces.
Description:
• Shopify uses Product Category to align products with its internal taxonomy (e.g., for SEO, sales channels, and third-party integrations).
• The field accepts the Category ID corresponding to a category in Shopify’s Product Taxonomy.
This field is available only for export and represents the full category path assigned to the product based on Shopify’s standard product taxonomy.
The app automatically fetches metafields from your Shopify store, allowing you to select and map the ones you want to import.
Description:
• You can map any available product metafields by selecting them from the dropdown.
• Click “Sync” to refresh the metafield list from your store.
This field lets you define the value to import or export for the corresponding metafield.
Description:
• Select the column from your file (or data source) that contains the value for the selected metafield.
• Make sure the value matches the type and format defined in your Shopify store’s metafield settings (e.g., text, number, list, file, reference, etc.).
• For export, this will extract the current value stored in the metafield for each product.
• If your store is multilingual, you can map translated metafield values per language (if available in the file).
