The product variation available on Shopify exceeds the allowed option values on Square.

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

⚠️ The product variation available on Shopify exceeds the allowed option values on Square.

❓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 will fail.

📌 Example Scenario

Imagine you are uploading a t-shirt from Shopify to Square, and you have an option called Size. If Square already has 250 values stored under the Size option (like Small, Medium, Large, XL...), and your product has a new value like "3XL" or "Triple XL", it will fail to upload.

⚠️ Note: Square treats variation values as case-sensitive. For example: Triple XL ≠ triple xl. Even a slight mismatch in capitalization will be treated as a new value.

✅ How to Resolve the Error?

You have two possible solutions:

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.

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!

Updated on: 23/07/2025

Was this article helpful?

Thank you!