Shopify has limits on how much data you can store and how fast apps can write it – Variants per Product, images per Product, character length of titles and tags, metafields, redirects and the API call limit. These Shopify limitations apply to every app that uses the Shopify API, so they also apply to Matrixify imports. This page lists the Shopify limits we have found and tested, and what the app does when a limit is reached.
Have you come upon a limit that we have not listed? Reach out to us so we can inform others too. Contact us here!
Products
Title
Limit:
255 character limit
Description:
A Product Title can be up to 255 characters. Importing a longer Title value will fail the row with an error. Shorten the value in the file and import the failed rows again.
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Tags
Limit:
255 character limit for each tag
250 tags per Product
Description:
Each individual tag can only be 255 characters long. This includes single spaces. Double spaces will be converted to single space.
A Product can have up to 250 tags. Shopify Plus stores do not have the 250 tags limit. Tags are not case sensitive, so “Sale” and “sale” are the same tag.
Variants Daily Limit
Limit:
Once the store has 500,000 Variants or Products, the store is limited to 10,000 new Variants per day
Description:
Shopify will limit Variants you can create in your Shopify store. The limit is currently set to 10,000 variants per 24 hour period, once a shop has 500,000 variants (subject to change).
Does not affect Shopify Plus stores.
More info about it here.
You can also automate Matrixify to import products that failed with this error every day so you do not need to manually upload a file each day.
Variants per Product
Limit:
2048 Variants per Product
Description:
The Shopify variant limit is 2048 Variants per Product. Some themes and apps still support only 100 Variants per Product, so check your theme before importing Products with more than 100 Variants. If a Product in the file has more than 2048 Variant rows, the whole Product will fail to import.
Options per Product
Limit:
3 Options per Product
Description:
Shopify allows up to 3 Options for a Product, for example Size, Color and Material. This is why the Products sheet has Option1 Name, Option2 Name and Option3 Name columns and no fourth one. If your source data has more than 3 attributes per Variant, join two of them into one Option value, for example “Red / Cotton”, or store the extra attribute in a Variant Metafield.
Images per Product
Limit:
250 Images per Product
Description:
Shopify limits how many images each product can have, currently, the limit is 250 Images per Product.
Image size
Limit:
20 megapixels and 20 megabytes
Description:
Shopify limits images to a maximum size of 4472 by 4472 pixels (20 megapixels) and a file size of up to 20 megabytes.
See Website Image Size Guidelines.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: specs.material [string]“.
For more information about Metafields check out our:
Collections
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Title
Limit:
255 character limit
Description:
Shopify does not allow Collection Titles longer than 255 characters. Importing a longer Title will fail the row with the error “is too long (maximum is 255 characters)”.
Source: Title
Limit:
255 character limit
Description:
Shopify stores a Source Title of at most 255 characters. If a longer value is imported, the app will cut it to 255 characters and add a warning to the Import Results. Source: Description does not have this limit.
Sources per Collection
Limit:
Maximum 10 Sources
Description:
One Collection can have at most 10 Sources. Importing a Collection with 11 or more Sources will fail with the Shopify error “Too many sources”. Join the conditions into fewer Sources or a separate Collection.
Condition values per Source
Limit:
Maximum 60 condition values per Source
Description:
Shopify allows at most 60 condition values in one Source, counted across all its conditions – a single condition with 61 values hits the limit just like 61 separate conditions. Importing more will fail the row with the error “A source can contain at most 60 condition values across all conditions”. As a Collection can have up to 10 Sources, the conditions can be split across several Sources to go beyond 60.
Sources with conditions per store
Limit:
Maximum 5,000 Sources with conditions
Description:
A store can have at most 5,000 Sources that contain conditions, counted across all Collections – a Collection with three rule-based Sources uses three of them. Collections and Sources built only from Manual Selections are not counted and can still be created.
Collections with Variants per store
Limit:
Maximum 100 Collections with Variants source
Description:
A store can have at most 100 Collections that contain any manually or automatically added variants, i.e. Collections with a Variants Source.
Collections containing another Collection per store
Limit:
Maximum 50 Collections with Collections Source
Description:
A store can have at most 50 Collections that include another Collection, i.e. Collections with a Collections Source.
Collections excluding another Collection per store
Limit:
Maximum 5 Collections excluding other Collections
Description:
A store can have at most 5 Collections that exclude another Collection, i.e. use the Collection field with Inclusion: Type = Exclude.
Smart Collections
Multiple Sources and new Source types
Limit:
Smart Collections can only manage a single Products Source.
Description:
The Smart Collections sheet works only with Collections that have one Source with Products type. Collections built with several Sources, or with Variants, Collections or App Sources, cannot be created or updated from this sheet – the row will fail with the error “Cannot find or create Smart Collection with Title […] and Handle […]”. Use the Collections sheet for such Collections.
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Smart Collection Count
Limit:
5,000 total Smart Collections
Description:
A store can only have 5,000 total Smart Collections
Smart Collection Rule/Condition Count
Limit:
60 Rules/Conditions
Description:
A single Smart Collection can have up to 60 Rules/Conditions
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: specs.material [string]“.
For more information about Metafields check out our:
Custom Collections
Multiple Sources and new Source types
Limit:
Custom Collections can only manage a single Products Source.
Description:
The Custom Collections sheet works only with Collections that have one Source with Products type. Collections built with several Sources, or with Variants, Collections or App Sources, cannot be created or updated from this sheet – the row will fail with the error “Cannot find or create Custom Collection with Title […] and Handle […]”. Use the Collections sheet for such Collections.
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Custom Collection Count
Limit:
Soft limit 100,000 total Custom Collections
Description:
Technically there is no limit, but Shopify suggests a soft limit of 100,000. More can cause store and Admin performance issues.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: specs.material [string]“.
For more information about Metafields check out our:
Customers
Tags
Limit:
255 character limit for each tag
Description:
Each individual tag can only be 255 characters long. This includes single spaces. Double spaces will be converted to single space.
Note
Limit:
5,000 character limit
Description:
A note for the Customer can be a maximum of 5,000 characters long.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: details.gender [string]“.
For more information about Metafields check out our:
Companies
Locations
Limit:
10,000 Locations per company
Description:
Single company can have maximum 500 locations.
Shopify manual reference.
Linked Customers
Limit:
10,000 Linked Customers per company
Description:
A single company can have maximum 500 customers linked to it.
Shopify manual reference.
Roles per location
Limit:
50 Roles/customers per Company Location
Description:
Single Company Location can have maximum 50 Roles. So you cannot assign more than 50 Customers to the location.
Shopify manual reference.
Discounts
Discounts or Discount Codes
Limit:
20,000,000 total
Description:
Currently, there is a limit of 20M price rules and 20M discount codes per shop.
Applies to Collections, Products or Variants
Limit:
100 Collections or 100 Products or 100 Variants.
Description:
Shopify limits that a single Discount can be applied to a maximum of 100 items (collections, products or variants).
Orders
Name
Limit:
255 character limit
Description:
The maximum length of the Name is 255 characters. If you import a name longer than that, then Shopify will cut it off at that maximum.
Tags
Limit:
40 character limit for each tag
Description:
Each individual tag can only be 40 characters long. This includes single spaces. Double spaces will be converted to single space
Order Note
Limit:
5,000 character limit
Description:
Order Note can be a maximum of 5,000 characters long.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: specs.material [string]“.
For more information about Metafields check out our:
Pages
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: group.other[string]“.
For more information about Metafields check out our:
Blog Posts
Handle
Limit:
255 character limit
Description:
In Shopify, all Handles have a limitation of 255 characters, so any Handle longer than that will be truncated to 255 characters by the app if importing longer Handle.
Image Alt Text
Limit:
255 character limit
Description:
Shopify limits Blog Posts featured image alt text to be maximum of 255 characters.
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: comment.valid [string]“.
For more information about Metafields check out our:
Redirects
Total Redirect Count
Limit:
- 100,000 total redirects for regular stores.
- 20,000,000 total redirects for Shopify Plus stores.
Description:
From our tests, it seems that Shopify only allows for a regular Shopify store to have 100,000 total redirects.
Shop
Metafields
Limit:
255 character limit for Metafield Namespace
64 character limit for Metafield Key
Description:
Each Metafield consists of 3 basic values – Namespace, Key and Value.
Namespace, in a way, is a folder in which Metafield is stored in. This “folders” name is limited in Shopify to 255 Characters.
Key is the name of the Metafield itself, in Shopify, this can be 64 characters.
Both namespace and key are what constructs Metafield column header in Matrixify as per this template – “Metafield: namespace.key [type]“, for example, “Metafield: data.validation[string]“.
For more information about Metafields check out our:
API Call Limit
Requests per second
Limit:
40 for regular stores
80 for Shopify Plus stores
Description:
The Shopify API Call Limit controls how many calls per second an app can make to your store. It does not limit how many items you can import, only how fast. Matrixify has an increased API Call Limit from Shopify – 300% for regular stores and 500% for Shopify Plus stores. When a job starts, you can see the API Call Limit and the number of parallel threads on the job page. The app slows down automatically when the limit is reached, so a job never fails because of it.
Read more about the Shopify API Call Limit and how it impacts the export and import speed.
Matrixify plan limits
Besides the Shopify limits on this page, each Matrixify subscription plan has its own limit of items per import or export job, for example, 5,000 Products per job on the Basic plan. There are no monthly or daily limits in the app. If a job has more items than the plan allows, it finishes with the status “Limited” and the remaining items are not processed.
See the item limits for each Matrixify plan.
