Product Variations Available on Shopify Exceeds the Allowed Options in Square

When uploading products from Shopify to Square, you may encounter the following error:

Product Variation Exceeds the Allowed Options in Shopify

What Does This Mean? #

Square places a limitation on how many values you can have for a single product option (like size, color, etc.).

Each product option on Square can have a maximum of 250 values.

If a new value exceeds this limit, Square will throw an error, and the product upload/update will fail.

Example Scenario #

Suppose you are uploading a T-shirt from Shopify to Square with a Size option.

If Square already has 250 Size values, adding a new value such as 3XL will cause the upload to fail.

Note: Square also treats variation values as case-sensitive. For example, Triple XL and triple xl are treated as different values.

How to Resolve the Error? #

You have two possible solutions:

1. Change the Option Name in Shopify:
   • Modify the option name (e.g., from Size to Sizes) to create a new option group.
   • This helps avoid using the pre-existing set of 250 values in Square.

1. Adjust the Option Value:
   • Edit the product’s variation value in Shopify to match an existing value already used in Square.
   • Example: Instead of Triple XL, use 3XL if it’s already in Square’s list.

Use this method when you are only dealing with a few conflicting values.

Summary #

• Square limits each variation option to 250 values.
• Errors occur when Shopify tries to push a new variation value not already available in Square.
• You can resolve it by changing the option name or adjusting the value to match existing ones.

If you have any questions, please connect with our support team and our team will be there for you. Happy Selling