See what each field/column from our “Products” template means including possible allowed values and examples.
Fields marked as “Export Only” cannot be imported/set in Shopify but can be exported with Matrixify export.
Excel Sheet Name
Products
When importing a file, to tell the app that you are importing Products, you need to ensure that the sheet/tab name is set to “Product” or “Products”.
For example:
- If using a CSV file then the file name can be “my-shopify-products.csv”
- If using an XLSX file then the sheet/tab name would be set to “Products”. The file name for the XLSX file does not matter.
Even if the sheet/tab name is not set correctly, you will be able to manually change and set the entity you are importing after uploading file in the app.
See more on the Matrixify app import process and import user interface.
Need a quick start?
Columns Available For Export And Import
Basic Columns
Column | Description / Example Value |
---|---|
ID | ID is automatically generated number by Shopify to identify the item. It is filled in by an Export. Can be used for Import to identify and update existing Products. When creating new Products, leave this value empty. Allowed ValuesNumber Example11920047631 |
Handle | This is what your store visitors will see in the product URL address, like this: https://etaystore.com/products/mom-strength-red-t-shirt-slim-fit .URL address has a great impact on SEO, so be sure to give it a meaningful name. Regardless, what you write here, the app will convert it to lowercase, and remove all non-URL friendly symbols. You can leave it empty when creating new Products – in that case, the app will generate it for you from Title.If the handle will have non-Latin characters like Chinese, Arabic or Russian, or any other language, it will get “transliterated” to the similar-sounding Latin letters by default. You can switch this option off in Options upon importing by unchecking “Transliterate Handles to English alphabet”.Each product Handle must be unique across your Shopify store, so when creating new products from external data source, even better approach would be to create Handle from Title and original product ID using Excel formula like this: =C2 & ” ” & B2 (assuming that you put some original product ID in the B column). Whatever you will put in the Handle column, the app will convert it to the required Handle format, which is acceptable by Shopify.When updating Handle the app by default will also create a Redirect from old Handle to the new one. You can turn this off in the Import options with importing a file.In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters. Allowed ValuesAny characters allowed in a URL Examplemom-strength-red-t-shirt-slim-fit-123456 |
Command | When importing Product row – tell the app, what to do with it:
If no Command is specified, then the app will assume the See our tutorial on how Matrixify identifies Products when importing. Allowed ValuesNEW MERGE UPDATE REPLACE DELETE IGNORE ExampleMERGE |
Title | Title of the Product.
When creating a new product, this is the only mandatory field for the Product. When importing Product update Title can be used as identification for Product (there is no ID or Handle). Allowed ValuesText ExampleMom Strength Red T-shirt Slim Fit |
Body HTML |
This is a long description of the Product. You can write here just a plain text, or format that text using HTML code. You can put here additional images, videos, links to other Products or sites, tables, and so on. You can learn about HTML capabilities online, for example W3Schools.com or use some online video courses, like from Treehouse.com or Udemy.com. The best way to create HTML for Product, is to write a Description in the Shopify Admin for one Product, format it as you like, and then do the export. Then you will see, how that translates to HTML, and will be able to apply the same to other Products. The app is also doing some helping with the descriptions automatically to make it easier to use and fix popular issues:
When exporting, by default the Body HTML value will only be filled in the first row for each product if the product has multiple rows. Allowed ValuesText, HTML Example<b>Features</b> <ol> <li>Looks nice</li> <li>Feels good</li> </ol> |
Vendor | Basically the Brand name.
Be sure to keep all the same Brand names written the same. For example, “H&M” and “H & M” (with spaces) will be appearing as two different brands. The Vendor field cannot be set empty in Shopify. Doing so with an import, Shopify will automatically set the Vendor to the store name. Allowed ValuesText ExampleNike |
Type | Shopify Product Custom Type – allows you to define a certain kind for each Product. Any text can be entered into this field.
To import/export Shopify Product Categories, use Category columns. Allowed ValuesText ExampleT-shirt |
Tags | Tags allow you to add additional elements or “properties” to your product, which you can use for filtering, for showing some additional information about the Product in the store.
Tags also are great, when Type column is not enough, and you need to create a hierarchy of some sort. For example, you might want to tell that this Product is a Shirt and a Skirt. In this case, you could add tags: Type: Shirt, Type: Skirt. Then you can create Smart Collections “Shirts”, where you include all Products which have Tag “Type: Shirt”, and another Smart Collection, where you include Products which have Tag “Type: Skirt”. That way this Product will be included in both Smart Collections. Tags column values are read joined together from all the duplicated product rows so if you like, you can have duplicate rows with each tag in its own row, and those all will be imported. See this tutorial on how to bulk manage your Tags. Allowed ValuesComma Seperated List ExampleColor: Red, Eatable, Featured, Type: Skirt |
Tags Command | Tell the app, what to do with Tags:
If Tags Command is not set, the app will assume the You can also have Tags listed in multiple rows within the item and with different Tags Commands. See this tutorial on how to bulk manage your Tags. Allowed ValuesMERGE DELETE REPLACE ExampleREPLACE |
Created At Export only |
It will be automatically set to the time when the Product was actually created in Shopify. When migrating from another store, this time will always be the time of migration. Allowed ValuesDate & Time Example2018-12-17 18:20:07 +0200 |
Updated At
Export only |
It will be automatically updated, whenever you change the Product data.
Allowed ValuesDate & Time Example2018-12-17 18:20:07 +0200 |
Status | Status of the Product in Shopify. Can be imported and exported.
By default, new Products are set to the If the field is imported as empty then it will be ignored as you cannot set the Status to nothing in Shopify. Allowed ValuesActive Archived Draft ExampleDraft |
Published | Tells, whether this Product should be Published in Online Store sales channel.
It works in combination with the column Published Scope. If you will leave this cell empty, then it will treat it as a Allowed ValuesTRUE FALSE ExampleTRUE |
Published At | This column can be exported and imported.
It will be automatically updated, whenever you publish the Product. You can set the product publication date in the past, by importing the specific date you like. Can be set to a future date to schedule publishing of the Product to the Online Store. To schedule publishing a product that is already published in the Online Store, make sure to also include the Published column with value Allowed ValuesDate & Time Example2018-12-17 18:20:07 +0200 |
Published Scope | Tells Shopify, where to publish this Product.
This column works in combination with the Published column the following way;
Changes to any other channels like Facebook, Wholesale, etc. are not available through this import. But you can follow this video tutorial to still change all the channels in bulk through the Admin, and play with filters and Tags (which you can import with Matrixify), to identify particular Products to publish/unpublish. By default, the published scope is set to Allowed Valuesglobal web Exampleglobal |
Template Suffix | Template Suffix allows you to specify another Template from your Theme for this specific Product. For example, you might want to specify different template for a Featured product, which has different page layout.
Work with your developer to create new Template or read Shopify documentation about adding additional Product templates. Once new Template is created, you can set in this column to activate it for needed Products. That different template will show as dropdown for Products in Shopify Admin, when new Product Template will be created in your Theme. For example, if the new Template file name is “product.featured.liquid”, then – to activate this Template for this Product, write “featured” as the Template Suffix. The default product theme template in Shopify is “Default product”. Allowed ValuesText Examplefeatured |
Gift Card | Tells, whether this Product is a Gift Card Product.
Can be set only when creating a product, cannot be updated! Check our tutorial on how to bulk import Gift Card Products. Setting value
Gift Card product in the Admin -> Products looks exactly the same as other Products. Allowed ValuesTRUE FALSE ExampleFALSE |
URL
Export only |
The Product page URL. |
Total Inventory Qty
Export only |
All variant inventory quantity sum. |
Row #
Export only |
Will have row number from 1 till the end for each row. So that if you change the sorting in your exported file to easier update your data, you can sort it back by “Row #” and return it to the original sorting. Because, you know, all the item data should be together – and if you change the sorting, you need to sort it back. |
Top Row
Export only |
It will have value TRUE for each “top row” of the item. That can help you filter in Excel to get only the base rows, in case you need to get rid of repeated rows for each item. Some sheets already had this as Primary Row column earlier, but we have added it now to all the sheets now and renamed to Top Row so it’s more clear. |
Category
Shopify Product Category.
You can see all Shopify available categories in Shopify Product Taxonomy page.
When updating Category, you do not need to use all 3 category columns. You can use any 1 or more columns from the list below. If importing from multiple columns, make sure that they reference the same category.
Column | Description / Example Value |
---|---|
Category: ID | ID for the Category that product is in.
See each category ID in the Shopify Product Taxonomy page by selecting a category and opening Category mappings > Shopify section. Alternative column headers
Allowed ValuesNumber Exampleaa-1 |
Category: Name | Category name.
You can see all Shopify available categories in Shopify Product Taxonomy page. When importing Product Categories using only the “Category: Name” column, if you have an error that multiple categories match the same name then you must also use “Category: ID” with the specific category ID or “Category” column with ID and/or breadcrumb for the specific category you need to set. Alternative column headers
Allowed ValuesText ExampleClothing |
Category | Full path/breadcrumb of the Shopify Product Category.
When importing, in this column you can set this column value as:
In the Shopify Product Taxonomy page select your category to find details about each category – in Category mappings > Shopify section you can see the category ID and in the “Breadcrumb” section the category full path. Alternative column headers
Allowed ValuesText ExampleApparel & Accessories > Clothing |
Collections
Each Product can exist in several Custom Collections and Smart Collections.
Column | Description / Example Value |
---|---|
Collection
Import only |
This column is only imported to maintain compatibility to Shopify CSV import. It doesn’t show up in the export, because all current collections are in “Custom Collections” column.
It contains the Collection Title where this product should be added. The Matrixify app will search for an existing Custom Collection by this title, and if it is found, then it will add this Product to that Custom Collection. If it finds several collections with the same Title, then it will add this product to the first of them. If such Custom Collection doesn’t exist, the Matrixify app will create it for you, and add this product there. You can add this product to several Custom Collections at once by repeating the product row and putting each Custom Collection title in its own row. Allowed ValuesText |
Custom Collections | This column is exported and imported.
It contains a comma-separated list of Custom Collections where this product is appearing. The values of this column are repeated for all the product rows (image rows and variant rows). This would allow tricks like – finding out which SKU is in which collection. When importing, the comma-separated list of those Custom Collection handles is being read from all the rows – so you can have several product rows with several comma-separated Handles there. If this cell is empty in the export, it means that this particular product is not included in any of the Custom Collections. If you are importing empty value for this column, it will not remove this product from any collection – it will just add it to whatever collection is mentioned here. To work with Custom Collections in more detail, please, refer to the Custom Collections documentation or see the tutorial: How to add Products to Shopify Custom Collections (also known as Manual Collections). You can also list Custom Collection Titles and Matrixify will generate Handle from that and search for collection with such Handle. Allowed ValuesComma-seperated Collection Handles Exampledaily-picks, our-bestsellers |
Smart Collections
Export only |
This column is only exported.
It contains a comma-separated list of Smart Collections where this product is appearing. The values of this column are repeated for all the product rows (image rows and variant rows). This would allow tricks like – finding out which SKU is in which collection. If this cell is empty, it means that this particular product is not included in any of the Smart Collections. To include the product in a Smart Collection, please, refer to the Smart Collections documentation or see the tutorial: Create Smart Collections in bulk by Product Tags. Allowed ValuesComma-seperated Collection Handles Examplered-shirts, discounted |
Media
Each Product can have several media files.
In the Matrixify export, each of those will be exported in a different row with all the media file details in that row for each file.
Each variant can be linked to one of the images. Variants can only be linked to images (media with Image Type
as IMAGE
)
Columns and rows of media files do not correlate with Variant columns and rows. So Variant Image
and Image Src
rows are not aligned. Each of the column groups lives their own life.
Don’t let the “image” word in the media column names confuse you (Image Type
, Image Src
, Image Postion
, etc.) – that’s because some time ago the Shopify allowed to add just images to their products, but now you can add all sorts of media like video and 3D models. For the sake of compatibility, we decided to keep the column names unchanged (for now).
Column | Description / Example Value |
---|---|
Image Type
Export only |
Type of the media file in Shopify.
Allowed ValuesIMAGE VIDEO EXTERNAL_VIDEO MODEL_3D |
Image Src | Link to the media file. This link must be publicly available and direct link so that Shopify is able to download file from it.
Once files are imported, those don’t need to be hosted anymore with this link, because Shopify will download this it and store on their own servers. To import several media files for the same Product, you have multiple options:
If you need to add an additional media files, you don’t need to mention existing files – just mention those files, which you need to import, and use If the If Shopify will not be able to download all files, the warning about that will be put in the Import Results file “Import Comment” column. Links listed in this column need to be direct and public links. You can also import images from FTP/SFTP links by using image links in the following structure: When exporting, the Matrixify app will export associated media links, but not the media files themselves. If you are looking to export actual media files please refer to Matrixify tutorial “Download all files from Shopify Files to your computer“. Supported file types:
See Shopify manual on file types, sizes, and other limitations for product media. Allowed ValuesURL Examplehttps://images.com/image.jpg; https://images.com/another-image.jpg |
Image Command | Here you define the action what to do with media:
Media is never deleted or removed by default – only when you will give the explicit command to do so. If Image Command is empty or such column doesn’t exist, then the Allowed ValuesMERGE DELETE REPLACE ExampleMERGE |
Image Position | The position of the particular media file within the product.
You can reorder media files inside one product by doing Export, changing those Position values, and importing back as an image column update. When importing several media files with the semicolon, the media position numbers will be auto-incremented starting from this given number. If you import different product or variant media files with the same position number, the Matrixify app will not overwrite the existing image at that position. The numbers you assign to the “Image Position” column do not have to be in a sequential order. Allowed ValuesNumber Example5 |
Image Width
Export only |
The width of the image, in pixels.
Allowed ValuesNumber |
Image Height
Export only |
The height of the image, in pixels.
Allowed ValuesNumber |
Image Alt Text | By SEO best practices, it is strongly suggested that media files have “alt text” specified, because this is how search engines know, what’s inside that file.
Allowed ValuesText ExampleT-shirt small size |
Image Attachment
Import only |
Import without a public link but list actual data encoded in Base64.
Allowed ValuesA Base64 encoded media file. Example 1data:image/png;base64,PGJhc2U2NC1lbmNvZGVkPg== Example 2iVBORw0KGgoAAAANSUhEUgAAAL4AAAC+CAIAAAAEFiLKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAN8SURBVHhe7dc9ThtbGIDhu7PbZiFU7MMNC0FiH0g0t6WkiCJRpk3JHXvG9ozBRHmlSMnR82gKmD9bOi/fEf+8QSIdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJ56e+77789++Xl8fl1/cubvhxfzv9+vkjIxgmnXn99sfuaTm19+31Zjn/yULOi33thl9L5+vD8+V3GNRg6TzfTBHcvn5dTs4LeTjZ0/k10vnrLH/694dW7r+tTt69bsp4epmH03TcPPxY7S+HY8ruMKhuHl6Ps+Qc1pzF4anlPas37G94vDu+Z/+ql93+/PbLrLL+242WzuOy8OfV3T2thsp0dVm89aRZ/3ze446TY331+CmbDjaPr6fOldQGMVw680IeFvUwA45njkt7crg6j4SP0jmPh+3V1dD6qK2LDetc2OrjBjFeOvPiPd8/HQq4+36xtJs95ZN09g/OtleXD7ra1jadUzGHe86PjGDAdFb/VV2WsV7Xn0ydK+nMb5iP4+7zWTrLlLp9nt450m41GTGdZS1Pf+UX6cy5zPfPP293k0/SOe9l7z/uSjqnL3N6/yiGTGdZv4+mwnzb/tjdTfNgm8t0TFlcT2fe7OYslvHzbkN8l87xzrF2q8kw6fzBhvvfaiad3249q0Yind9s2QqX7Wwk0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIukQSYdIOkTSIZIOkXSIpEMkHSLpEEmHSDpE0iGSDpF0iKRDJB0i6RBJh0g6RNIhkg6RdIikQyQdIumQvL39Dxdu/LzXDU5QAAAAAElFTkSuQmCC |
Inventory / Variants
Each Product can have several variants, that is a different version of a product, for example, size or color.
All those variants can be imported, as well as exported.
To add several Variants to a Product, you need to add an additional row for each Variant. Import will know that the Variant belongs to the same Product, if that added spreadsheet row will have the same ID, Handle or Title (whichever comes first). All the other Product base columns (which are not variants) are ignored for Variant rows. That means that you can either leave them empty, or just copy the same previous line – which in some cases can be much more convenient. Basically, when you are copying rows, you don’t need to empty the cells of copied product information.
Those all are columns, which are accessible in Shopify Admin, when adding new product Variant.
Shopify allows maximum of 100 Variants per Product.
Column | Description / Example Value |
---|---|
Variant Inventory Item ID
Export only |
Global Inventory Item identifier. It is the new way of how Shopify identifies inventory item across many locations. We are transitioning the app gradually to this new approach. Read more here.
Allowed ValuesNumber |
Variant ID
|
Shopify internal ID for each product variant.
If the Product in the store has no Variants, it will still have Variant ID as such Products still have default Variant that has variant-specific attributes such as price, inventory, SKU, and others. Importing:Each Variant, after imported, gets its own Variant ID, assigned by Shopify. You can also use Variant ID to identify Products when updating them. When importing, if you also have the ID column with an existing ID value and have a Variant ID that does not exist within the Product, then the app will fail the product to ensure that the IDs are valid and correct in the file. This is a special validation in the app to ensure that if the file has IDs they are correct and not mixed up or broken. Exporting:When you will Export Products, then Variant ID will serve as a reference to whichever Variant you want to update. You can update one or many columns for Variant by keeping the Variant ID in the import file. That way the import will know precisely, which Variant you need to update. Allowed ValuesNumber Example41920047632 |
Variant Command | Whenever variants are imported, there is always one of those commands executed for each of variant rows:
If no Variant Command is specified, then the See this Tutorial for more details about adding variants: How Add Variants To Existing Product. Allowed ValuesMERGE UPDATE DELETE REPLACE ExampleMERGE |
Option1 Name | Each product can have 3 Options, with many values per option.
This Option1 Name column is the name of 1st Option. The value of this 1st option is to be written in the Option1 Value column, which becomes so-called Variant of the product. You can have those options empty, if you don’t have any options to choose from. Then you need to keep Option Values empty as well. Allowed ValuesText ExampleColor |
Option1 Value | The Value of Option1 Name.
For example, if we considered the Option1 Name to be a “Color”, then Option1 Value need to contain colors, like, Red, Blue, Green, and so on. You can have as many Option Values as you like. The Shopify global limitation here is that you can have up to 100 Variants per Product. All option value combinations must be unique, meaning that there is not allowed to be two variants with the same Option Values. For example, you can’t have two Variants with the same Color, Size and Fabric. At least one of those must be different. If you need to generate several options from the same cell, split them by ; (semicolon). The app will generate the combinations of all 3 option values – they all can have values split by ; (semicolon). Allowed ValuesText ExampleRed |
Option2 Name | The name of the 2nd Option.
Allowed ValuesText ExampleSize |
Option2 Value | The Value of the 2nd Option.
Allowed ValuesText ExampleXS |
Option3 Name | The name of the 3rd Option.
Allowed ValuesText ExampleFabric |
Option3 Value | The Value of the 3rd Option.
Allowed ValuesText ExampleCotton |
Variant Generate From Options
Import only |
You can also generate Variants from Options by having Option Values listed with a semi-colon. Then you will need to also specify in this field the value TRUE to tell the app that you wish to generate options.Check out tutorial for more details.
Allowed ValuesTRUE FALSE ExampleTRUE |
Variant Position | Variants can be sorted in specific order. This Variant Position tells that order.
You can update order of existing Variants by changing those numbers and importing them back as an update. And of course, you can import only this column. To do so you need to include the ID, Variant ID and Variant Position columns in your import file. Then app will determine which Product and which Variant you need to update. If the field is imported as empty then it will be ignored. Allowed ValuesNumber Example17 |
Variant SKU | SKU number is a “Stock Keeping Unit” reference number, usually used in wholesale to uniquely identify and reference the Product Variant. Some companies organize all their inventory by SKU numbers, which allows them to track items with precision.
When you import data from any dropshipping company, they will almost always have SKU number to identify their Product variants. It’s good practice to keep those SKU numbers from wholesale company or dropshipper in this column. It will be useful when your customer will place an order through your store, you will be able to tell the dropshipper this SKU number, and they will instantly know, which Product Variant is being ordered. If you have your own inventory, you can create your own SKU numbers, as simple as 1, 2, 3, or something more complex, which encodes your product category, or some other important information, like: TS000001RXSC. Variant SKU can also be used as a “key” to identify existing Products if the ID or handle is not known for the product. Read Tutorial: How to update Product by SKU? Allowed ValuesText ExampleTS000001RXSC
|
Variant Barcode | Shopify officially supports UPC or ISBN barcode types, but you can put here any other barcode format.
You can also use Variant Barcode to identify Products when updating them. Allowed ValuesText Example12500-00081 |
Variant Image | Link to your Variant image.
Rows of Variant Images are not aligned with rows of Image Src images. They each live their own life. It can be the same link, as you use in your Image Src for product image, or it can be a different link, which is specific to this Variant. If this link will be one of those, which you also have for Image Src column, then it will recognize it and use the same Product image for Variant. If that will be a link, which is not listed in Image Src column, then it will add this image to Product images too. Each Variant can have only one image. If the app will not be sure that the correct image is mapped to a variant image, due to missing images, then warning about that will be written in Import Results file “Import Comment” column. Allowed ValuesURL Examplehttps://images.com/image.jpg |
Variant Grams | Imported only (to be compatible with Shopify CSV columns format).
Regardless of the weight that you will show on your Store, you can specify weight in grams. Will use the value of this column only when there is no Variant Weight column. When showing Product information, Shopify will convert those grams to whatever Weight Unit you will need to use. Allowed ValuesWhole Number Example200 |
Variant Weight | The variants shipping weight in the specified Variant Weight Unit.
If imported empty, the resulting value in Shopify will be Allowed ValuesNumber Example1.2345 |
Variant Weight Unit | The variants shipping weight unit to show Clients. Shopify will automatically convert grams to this weight unit.
If imported empty, Shopify will set the weight unit to the store’s default weight unit (set in Shopify Admin > Settings > Store details > Time zone and units of measurement). Allowed Valuesg kg oz lb Examplelb |
Variant Price | The price of the Variant item in the currency, which you have set for your Store.
Allowed ValuesDecimal Number Example389.99 |
Variant Compare At Price | The original price, if your Variant Price is a discounted price.
Which means – if you want to show that a Variant is being sold at a discount, then you set your Variant Price to a new, discounted price, and set this “Variant Compare At Price” to the old, original price. Neat Trick If you want to create a Smart Collection, which shows all Discounted Products, you can create a Smart Collection with a Rule, which says: include all Products with Variant Compare At Price is greater than 0. Even Neater Trick If you want to create a Discount Code and allow to use it only for Products which are not sold already at a discount – you can create a Smart Collection, which includes only Products, where Variant Compare At Price equals 0. And then attach that Collection to your Discount Code. But here is the problem – if your Variant Compare At Price will be empty, those Products will not be included in this list, and basically Customer will not be able to use their Discount code for them. To make those Products appear in that “Undiscounted Products” Collection, you need to set all non-discounted product variants Variant Compare At Price to be exactly 0. Voalá! Allowed ValuesDecimal Number Example499.99 |
Variant Taxable | If you set it to TRUE , then Shopify will charge additional Tax on the item price, taking in account your store Tax settings.
If you set it to If you leave it empty, then it will be assumed as Allowed ValuesTRUE FALSE ExampleTRUE |
Variant Tax Code | Specifies the Avalara tax code for the product variant. Will export and import only for stores that have the Avalara AvaTax app installed.
Allowed ValuesText ExampleDA040000 |
Variant Inventory Tracker | In the Shopify admin, this value shows as the “Inventory tracker” toggle, whether the tracking is enabled or not.
To enable Shopify to track inventory, set the cell value to You cannot use values “True” and “False” in the column as in Shopify back-end this is not a boolean, and using boolean values will return an error when importing. Allowed Valuesshopify <Handle-of-tracking-service> Exampleshopify |
Variant Inventory Policy | When Shopify is tracking your inventory, it needs to know, what to do, when Variant quantity reaches 0, which means, you are out of stock.
This column manages the Shopify Admin attribute checkbox “Continue selling when out of stock”. Allowed values are:
If the field is imported as empty then it will be ignored as you cannot set the Inventory Policy to nothing in Shopify. Allowed Valuesdeny continue Exampledeny |
Variant Fulfillment Service | There are warehouses or dropshippers who can package and ship the item to your Customer, when they place an order. That is called a Fulfillment Service. You can connect this, so that whenever item is ordered from your Store, the Fulfillment Service provider instantly ships that order to your Customer – automatically.
You can have several Fulfillment Services connected to your store, and each Variant can be linked with one of them. If you want to fulfill orders manually, you can enter the value If you want a Fulfillment Service to ship your orders, then you should enter here the Handle of the Fulfillment Service. You can find this Handle by setting a chosen fulfillment service for one of your Variants in your store, and then doing the Export. In the Export file you will see the Handle of this Fulfillment Service. If the field is imported as empty then it will be ignored as you cannot set the Fulfillment Service to nothing in Shopify. Allowed ValuesText Examplemanual |
Variant Requires Shipping | Variants can be shippable or not. Non-shippable Variant would be a digital good, which you sell.
If you set it to If this is If you leave this empty, then it will be assumed as Allowed ValuesTRUE FALSE ExampleTRUE |
Variant Inventory Qty | Quantity of available Product Variants in your stock.
Will be automatically updated, when items are sold, if Variant Inventory Tracker is set to This number is the total quantity across all your locations. If you will import the number in this column and will have no columns with Inventory Available: … or Inventory Available Adjust: … then this quantity number will be set for your primary location. Allowed ValuesNumber Example5839 |
Variant Inventory Adjust | The number to adjust the inventory difference – a positive number will add inventory to existing quantity, a negative number will subtract the inventory quantity.
When importing this column, the Variant Inventory Qty cannot be imported (because it doesn’t make sense to set and adjust the inventory at the same time). Allowed ValuesNumber Example-20 |
Variant Cost
When exporting, selecting “Variant Cost” will include this field in the exported file for each Variant with the value that each Variant has set.
If no “cost” value is set for the Variant in Shopify then this field will be empty for that Variant,
Column | Description / Example Value |
---|---|
Variant Cost | The “Cost Per Item” value which is usually the cost of this item from your supplier.
Alternative column headers
Allowed ValuesDecimal Number Example200.22 |
Customs Information
Column | Description / Example Value |
---|---|
Variant HS Code | The general Harmonized System (HS) code for the Variant.
Allowed ValuesNumber Example123456 |
Variant Country of Origin | The two-digit code for the country where the Variant was made.
Allowed ValuesCountry Code ExampleCA |
Variant Province of Origin | The two-digit code for the province where the Variant was made. Used only if the shipping provider for the inventory item is Canada Post. Allowed ValuesProvince Code ExampleQC |
Multi-Location Inventory Levels
Product Variants inventory in each location is set within multiple variants inventory quantities – Available, On Hand, Committed, Reserved, Damaged, Safety Stock, Quality Control, and Incoming.
When exporting, each location will have its own inventory columns with the location name indicated in the column header.
To remove a location from the Product Variant, set an empty value in all the inventory columns you have in the file for that location.
To add location to the Product Variant, set the value for any inventory type that can be imported, for example, Inventory Available in that location. If not tracking the inventory, then the value “Stocked” can be used instead.
Read more about Multi-Location Inventory.
Column | Description / Example Value |
---|---|
Inventory Available: <Location Name> | The quantity of available stock in a certain Location for a specific Variant.
If you need to adjust your available inventory by a certain delta quantity, then don’t include this column in the import, but use the Inventory Available Adjust: … column for the delta number. Allowed ValuesNumber or value Example1000 |
Inventory Available Adjust: <Location Name> | With this column, you can adjust your available inventory by a certain quantity instead of setting a fixed number.
If you need to import a fixed quantity for each location, then don’t import this column or import it empty. Use the Inventory Available: … column for that. Allowed ValuesNumber Example-5 |
Inventory On Hand: <Location Name> | The quantity of on-hand stock in a certain Location for a specific Variant.
On Hand inventory in Shopify is linked to Available inventory and changing it will also change the Available inventory quantity values. If you need to adjust your on-hand inventory by a certain delta quantity, then don’t include this column in the import, but use the Inventory On Hand Adjust: … column for the delta number. Allowed ValuesNumber Example1000 |
Inventory On Hand Adjust: <Location Name> | With this column, you can adjust your on-hand inventory by a certain quantity instead of setting a fixed number.
On Hand inventory in Shopify is linked to Available inventory and changing it will also change the Available inventory quantity values. If you need to import a fixed on-hand quantity for each location, then don’t import this column or import it empty. Use the Inventory On Hand: … column for that. Allowed ValuesNumber Example-5 |
Inventory Committed: <Location Name>
Export only |
Product Variants committed inventory quantity at a specific location.
Example58 |
Inventory Reserved: <Location Name>
Export only |
Product Variants reserved inventory quantity at a specific location.
Example25 |
Inventory Damaged: <Location Name> | The quantity of damaged stock in a certain Location for a specific Variant.
If you need to adjust your damaged inventory by a certain delta quantity, then don’t include this column in the import, but use the Inventory Damaged Adjust: … column for the delta number. Allowed ValuesNumber Example1000 |
Inventory Damaged Adjust: <Location Name> | With this column, you can adjust your damaged inventory by a certain quantity instead of setting a fixed number.
If you need to import a fixed damaged quantity for each location, then don’t import this column or import it empty. Use the Inventory Damaged: … column for that. Allowed ValuesNumber Example-5 |
Inventory Safety Stock: <Location Name> | The quantity of safety stock in a certain Location for a specific Variant.
If you need to adjust your safety stock inventory by a certain delta quantity, then don’t include this column in the import, but use the Inventory Safety Stock Adjust: … column for the delta number. Allowed ValuesNumber Example1000 |
Inventory Safety Stock Adjust: <Location Name> | With this column, you can adjust your safety stock inventory by a certain quantity instead of setting a fixed number.
If you need to import a fixed safety stock quantity for each location, then don’t import this column or import it empty. Use the Inventory Safety Stock: … column for that. Allowed ValuesNumber Example-5 |
Inventory Quality Control: <Location Name> | The quantity of quality control stock in a certain Location for a specific Variant.
If you need to adjust your quality control inventory by a certain delta quantity, then don’t include this column in the import, but use the Inventory Quality Control Adjust: … column for the delta number. Allowed ValuesNumber Example1000 |
Inventory Quality Control Adjust: <Location Name> | With this column, you can adjust your quality control inventory by a certain quantity instead of setting a fixed number.
If you need to import a fixed quality control quantity for each location, then don’t import this column or import it empty. Use the Inventory Quality Control: … column for that. Allowed ValuesNumber Example-5 |
Inventory Incoming: <Location Name>
Export only |
Product Variants incoming inventory quantity at a specific location.
Example73 |
Pricing by Catalogs
Import and export market and B2B company location specific fixed pricing and manage if products are included in individual Shopify catalogs.
To import/export pricing by catalogs, your catalog names in the store need to be unique.
Column | Description / Example Value |
---|---|
Included / <Catalog Name> | Indicates if the whole Product is included/published in the specific Catalog.
Set only in the first row of each product as in Shopify only the whole product can be included in the Catalog, not individual variants. Example column header – Alternative column header
Allowed ValuesTRUE FALSE ExampleTRUE |
Price / <Catalog Name> | Fixed Variant price in the specific Catalog.
Importing this field empty for a Catalog, will also clear that compare at price in the market for this variant. Example column header – Alternative column header
Allowed ValuesNumber Example53 |
Compare At Price / <Catalog Name> | Fixed Variant compare at price in the specific Catalog. To set a fixed compare at price in a Catalog, also price in that Catalog is required.Example column header – Compare At Price / North America .
Alternative column header
Allowed ValuesNumber Example84 |
Metafields
Read the more detailed documentation on Metafields page.
Metafields for SEO
Metafield Column Name | SEO Field |
---|---|
Metafield: title_tag [string] | SEO Title.
Alternative column headers
|
Metafield: description_tag [string] | SEO Description
Alternative column headers
|
Metafields for Google Shopping
Those are the same fields that you import and export with Shopify CSV files, just they are actually stored as the following Metafields in Shopify:
Note that other Google Shopping apps might store Google Shopping data in other Metafields – so be sure to Export a sample product to see in which Metafields the data you need to change, is stored.
Variant Metafields
Variant Metafields are metafields that are attached to each Variant. The column name for variant metafield starts with “Variant Metafield: “, followed by the namespace.key – the same way as the Metafields.
For example:
- The variant metafield with name “buy_price” in the global namespace should be called “Variant Metafield: buy_price”.
- The variant metafield with name “description” in the “details” namespace should be called “Variant Metafield: details.description”.
Note that exporting and importing Variant Metafields will significantly increase the time it takes to process the items because each variant metafield needs separate request to the Shopify API. Therefore, be mindful and export/import variant metafields only when you really need them.
Read the more detailed documentation on Metafields page.
Export Filters
In the Matrixify app, you can apply filters to Export only specific items from your Shopify Store.
When creating new export, select what you wish to export, and under that entity click on the “Filters” button.
Note: total displayed item count and estimated time won’t be affected by the filters applied.
Filter | Description |
---|---|
ID | Allows you to list specific Product IDs to export, separated by a comma.
Possible Conditions
Example12311123423,2342342342 |
Handle | Allows you to export specific product by its Handle.
Possible Conditions
Examplemy-product-handle |
Title | Allows you to export Products whose Title contains specific text.
“Matches pattern” condition allows entering wildcard symbols. Possible Conditions
ExamplePart of Title, other title Title * End of Title |
Body HTML | Allows to export Products which does or does not contain specific string of text in their description.
Possible Conditions
ExamplePart of product description |
Vendor | Allows you to export Products that have specific Vendors, separated by a comma.
Possible Conditions
ExampleVendor-1, Vendor Other |
Type | Allows you to filter by many Type values, separated by a comma.
Possible Conditions
ExampleType-1, Type-2 |
Tags | Allows to export Products that have all listed tags, any of listed tags or none of the listed tags. Separated by a comma.
Possible Conditions
Exampletag1, tag2, tag3 |
Created At | Allows exporting Products which were created in the Shopify within a specific date range.Relative date condition allows you to export Products that have been created in the last full amount of time.
For example – Last 1 Days, would export Products from last full day, so yesterday. Possible Conditions
|
Updated At | Allows exporting Products which were last updated in the Shopify within a specific date range.Relative date condition allows you to export Products that have been updated in the last full amount of time.
For example – Last 1 Days, would export Products from last full day, so yesterday. Possible Conditions
|
Status | Allows filtering Products export by the Products status in Shopify.
You can select multiple conditions in this filter. Selecting all would be the same as not applying the filter. Possible Conditions
|
Published At | Allows exporting Products which were published in the Shopify within a specific date range.Relative date condition allows you to export Products that have been published in the last full amount of time.
For example – Last 1 Days, would export Products from last full day, so yesterday. Possible Conditions
|
Published | Allows exporting only Products that are Published or Unpublished.
Possible Conditions
|
Collection | Allows to export Products who are in any of the collections with matching collection IDs, Handles or Titles. Separated by a comma.
Possible Conditions
Example123111222333, my-collection-handle, My Collection Title |
Variant ID | Allows to export Products that have variant/s with specific variant IDs.
Possible Conditions
Example123111222333, 354287234843, 89721346781 |
Variant SKU | This filter allows to include in the export only those Products where at least one of their Variants has a SKU that matches the selected condition. A condition can have several values, separated by comma.
Possible Conditions
Examplesku1 fragment, sku2 |
Variant Barcode | This filter allows to include in the export only those Products where at least one of their Variants has a Barcode that matches the selected condition. A condition can have several values, separated by comma.
Possible Conditions
Example12395876123 |
Variant Taxable | Exports only Products where at least one variant is or is not taxable.
Possible ConditionsYes |
Variant Weight | Allows you to export only those Products whose Variants have this specific weight.
Possible Conditions
Example29.46 |
Variant Price | Allows you to export only those Products whose Variants have this specific price.
Possible Conditions
Example5.99 |
Variant Inventory Qty | Allows you to export only those Products whose Variants have this specific quantity.
Possible Conditions
Example5 |
Metafield | Filters the Orders export by Product level Metafields.
Specify Metafield by:
Possible Conditions for Text value
Possible Conditions for Number value
|
Good To Know
- To import several images and variants to Product, just repeat the row with the same ID, Handle or Title (whichever comes first).
- To repeat rows, you can copy the whole row as it is, and you don’t have to delete contents of Product base rows – that makes copying easier.
- Shopify exported CSV file, pasted to Excel [Products] Sheet, can be imported with the same columns. You just need to change SEO Description and SEO Title columns to Metafield columns, as shown in the table above.
- To not update some columns, remove those columns from Excel file. Then the Import will not touch them.
- If you will have the Column with an empty value, then this field will be changed to empty.
- To update existing Variant columns, remember to keep the “Variant ID” column.
- You can have an unlimited count of Metafields.
- Check out Matrixify tutorial on how to import your Products.