What Are Acceptable Values?
Acceptable Values are a comma-separated list that you enter in the Configure Attribute panel. When you enable this constraint, the AI sees both your prompt and the list of acceptable values, and it must return a value from that list. Example:- Acceptable Values:
Red, Blue, Green, Black, White, Gray, Yellow, Orange, Purple, Pink, Brown, Gold, Silver, Bronze - Prompt: “Based on and product images, identify the primary color.”
- Result: The AI will only return one of the 14 colors listed, even if the product is a shade of red that’s not on the list—it will return the closest match (e.g., “Red”).
When to Use Acceptable Values
Use Acceptable Values for categorical data where consistency matters:Best Use Cases
- Colors:
Red, Blue, Green, Black, White, Gray, Neutral, Multi-color - Materials:
Cotton, Polyester, Leather, Wool, Nylon, Metal, Wood, Plastic - Sizes:
XS, S, M, L, XL, XXLorSmall, Medium, Large - Product Types:
T-Shirt, Hoodie, Jacket, Sweater, Vest - Conditions:
New, Refurbished, Used, Open Box - Yes/No fields:
Yes, No, Not Specified - Compliance flags:
Compliant, Non-Compliant, Review Required - Channel requirements: Values that your sales channels demand (e.g., specific size codes for Amazon, Shopify, or marketplaces)
When NOT to Use Acceptable Values
- Freeform text: Descriptions, titles, detailed specifications where you need creative variation
- Numeric values: Prices, dimensions, weights (use the Number field type instead)
- Open-ended data: Reviews, stories, marketing copy
- Any field requiring flexibility: When you need the AI to generate unique, varied content
How Acceptable Values Work
The AI’s decision process:- It reads your prompt
- It sees the list of Acceptable Values
- It generates output but constrains it to the list
- If the ideal answer isn’t on the list, it picks the closest match
| Prompt | Acceptable Values | Product | AI Output |
|---|---|---|---|
| ”Identify the primary color of “ | Red, Blue, Green, Black, White | A navy blue shirt | Blue |
| ”Identify the primary color of “ | Red, Blue, Green, Black, White | A maroon burgundy sweater | Red (closest match) |
| “Identify the primary color of “ | Red, Blue, Green, Black, White | A gold-plated watch | White (closest match; no metallic option) |
How to Set Up Acceptable Values
- Open the Configure Attribute panel for your attribute
- Locate the “Acceptable Values” field (below the Prompt field)
- Enter values as a comma-separated list:
Value 1, Value 2, Value 3 - Spaces around values are automatically trimmed
- Save your changes
- Run a test generation to verify the AI respects the constraints
Impact on Data Consistency
Acceptable Values are the difference between scattered, inconsistent data and clean, queryable data.Before (no Acceptable Values)
- “Red”
- “Crimson”
- “Red - Bright”
- “Hot Red”
- “Deep Red”
- “Scarlet”
After (with Acceptable Values: Red, Blue, Green, Black, White)
- “Red”
- “Red”
- “Red”
- “Red”
- “Red”
- “Red”
Common Issues and How to Avoid Them
Issue 1: Value Not in List
Problem: The AI generates a value that’s not on your Acceptable Values list. Cause: Your Acceptable Values list is incomplete, or you didn’t define the prompt clearly enough. Solution:- Add the missing value to your list
- Or rewrite the prompt to guide the AI toward values on the list
- Example: Instead of “Identify the material,” try “Identify the primary material from this list: Cotton, Polyester, Wool”
Issue 2: Misspellings in Your List
Problem: Some SKUs get “Cotton” and others get “cotton” or “COTTON.” Cause: Inconsistent casing or spacing in your Acceptable Values list. Solution:- Define your list once with a clear standard (Title Case, lowercase, UPPERCASE)
- Copy-paste from that standard list rather than typing each time
- Example (good):
Cotton, Polyester, Silk, Linen, Wool - Example (bad):
cotton, Polyester, SILK, linen, Wool
Issue 3: Too Many Values Defeats the Purpose
Problem: You create a list with 500+ values, and it’s essentially no constraint. Cause: You’re using Acceptable Values like a hint rather than a real constraint. Solution:- Acceptable Values work best with 5-20 values
- If you have 50+ acceptable values, consider whether you actually need a constraint
- For very large option sets, focus on data quality in the prompt instead
Issue 4: Overly Specific Values Don’t Match User Input
Problem: Your Acceptable Values areSmall, Medium, Large but your source documents say S, M, L or Size S, Size M, Size L.
Cause: Mismatch between your value format and what the AI sees in source data.
Solution:
- Include the prompt instruction: “Return one of these exact values: Small, Medium, Large. Do not use abbreviations.”
- Or add both versions to your list:
Small, S, Medium, M, Large, L - Or normalize in the prompt: “Convert S/M/L abbreviations to Small/Medium/Large”
Advanced: Using Acceptable Values with Tags
You can reference other attributes in your prompt and still use Acceptable Values: Example prompt: “Based on , , and images, identify the intended audience. Return only one value.” Acceptable Values:Men, Women, Unisex, Children, Infants
The AI reads the product context and picks from your list.