> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://squareintegration-dpl.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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/update 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**:

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.

2. **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!