Shopify Product Data for AI Agents: The Attribute Completion Guide
AI agents query product data by attribute, not by keyword. When a user asks an AI agent to find a "vegan leather tote bag with 15-inch laptop compartment under $200," the agent needs to match against three specific attributes: vegan leather (material), 15-inch laptop compartment (dimension specification), and under $200 (price). If any of these attributes are absent from your product data, the product does not match -- even if the description clearly says all three things in prose.
This guide tells you exactly which attributes to complete for your product category.
Key Takeaways
- AI agents use attribute matching, not keyword matching -- this is the fundamental difference from traditional search
- The same attribute needs to be in three places to be fully effective: the product title, the metafield, and the schema markup
- Missing a single required attribute (like laptop compartment size) can exclude a product from 100% of queries that specify that attribute
- Attribute values must be in a machine-parseable format -- "fits up to 15-inch laptops" in prose is less reliable than a metafield with value "15 inches"
- Prioritise your highest-revenue products first; attribute completion compounds across your catalog over time
The Attribute Matching Problem
Traditional search worked with keyword matching. A product page that mentioned "waterproof hiking boot" ranked for searches containing those words. Keyword proximity, density, and page authority determined ranking.
AI agent commerce works differently. An agent parsing "find me waterproof hiking boots with at least 10mm heel-to-toe drop, size 10, under $200" needs to evaluate each product against four explicit criteria. If any criterion is missing from the product's structured data, the product is excluded from consideration.
This is binary, not ranked. Either the data is there and the product qualifies, or it is not and the product is invisible to that query.
The implication: incomplete attribute data is not a ranking disadvantage. It is an exclusion mechanism.
The Three Places an Attribute Must Live
For maximum AI agent discoverability, each key attribute should appear in three places:
1. Product title (for fast-path parsing):
Some AI agents extract attributes from product titles without reading metafields. "Summit Waterproof Trail Boot Women's, Size 10, 12mm Drop" is faster to parse than a title of "Summit Women's Boot."
2. Metafield (for structured querying):
Agents that query the Shopify Storefront API can filter on metafield values directly. A metafield specifications.heel_drop = 12 allows an agent to run a query: "find products where specifications.heel_drop >= 10."
3. Schema markup (for web-crawl parsing):
Agents that crawl product pages need the attribute in JSON-LD schema. additionalProperty in Product schema handles custom attributes:
`json
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "Heel-to-Toe Drop",
"value": "12mm"
},
{
"@type": "PropertyValue",
"name": "Waterproof Rating",
"value": "IPX7"
}
]
`
Category-by-Category Attribute Completion Guide
Apparel and Footwear
Priority attributes:
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Material composition | materials.composition | "78% cotton, 22% polyester" |
| Primary material | materials.primary | "organic cotton" |
| Fit type | sizing.fit | "slim", "regular", "oversized" |
| Size system | sizing.system | "UK", "EU", "US" |
| Care instruction | care.method | "machine wash 30°C, no tumble dry" |
| Country of manufacture | origin.country | "Portugal" |
| Vegan/leather status | materials.vegan | "true" or "false" |
| Sustainable certification | certifications.sustainability | "GOTS certified organic" |
For footwear, add:
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Heel-to-toe drop | specifications.heel_drop | "12mm" |
| Sole material | materials.sole | "Vibram rubber" |
| Waterproofing | specifications.waterproof | "GORE-TEX", "DWR treated", "none" |
| Activity type | use.activity | "trail running", "hiking", "everyday" |
| Lug depth | specifications.lug_depth | "4mm" |
Electronics and Technology
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Compatible devices | compatibility.devices | "iPhone 14, 15; Samsung S23, S24" |
| Operating system | compatibility.os | "iOS 16+, Android 12+" |
| Battery life | specifications.battery_life | "12 hours continuous use" |
| Connectivity | specifications.connectivity | "Bluetooth 5.3, USB-C, NFC" |
| Storage capacity | specifications.storage | "256GB" |
| Display size | specifications.display | "6.1 inches" |
| Warranty | warranty.duration | "24 months" |
| Certifications | certifications.standard | "FCC, CE, UL listed" |
| Box contents | packaging.contents | "device, USB-C cable, quick start guide" |
| Charging speed | specifications.charging | "65W fast charge" |
Bags and Accessories
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Laptop compartment size | specifications.laptop_fit | "fits up to 15 inches" |
| Internal dimensions | dimensions.internal | "38cm x 28cm x 12cm" |
| External dimensions | dimensions.external | "42cm x 32cm x 15cm" |
| Weight | specifications.weight | "0.85kg" |
| Material | materials.primary | "full-grain leather", "recycled nylon" |
| Vegan | materials.vegan | "true" |
| Water resistance | specifications.water_resistance | "water-resistant", "waterproof", "none" |
| Closure type | design.closure | "zip", "magnetic snap", "open top" |
| Strap options | design.straps | "detachable shoulder strap, top handles" |
Food, Supplements, and Beverages
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Ingredients | composition.ingredients | Full ingredient list |
| Key active ingredients | composition.actives | "500mg Vitamin C, 100mg Zinc" |
| Allergen information | allergens.contains | "contains: gluten, soy" |
| Allergen free-from | allergens.free_from | "gluten-free, nut-free" |
| Dietary certifications | certifications.dietary | "certified organic, non-GMO, kosher" |
| Calories per serving | nutrition.calories | "120 kcal per serving" |
| Serving size | nutrition.serving_size | "2 capsules", "30g" |
| Number of servings | nutrition.servings_per_pack | "30" |
| Country of origin | origin.country | "USA" |
| Vegan | certifications.vegan | "certified vegan" |
Home, Furniture, and Decor
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Width | dimensions.width | "180cm" |
| Depth | dimensions.depth | "85cm" |
| Height | dimensions.height | "74cm" |
| Weight | specifications.weight | "42kg" |
| Weight capacity | specifications.weight_capacity | "120kg" |
| Frame material | materials.frame | "solid oak" |
| Upholstery material | materials.upholstery | "linen blend" |
| Assembly required | assembly.required | "yes" or "no" |
| Assembly time | assembly.time | "approximately 45 minutes" |
| Tools included | assembly.tools_included | "yes -- Allen key included" |
| Room suitability | use.room | "living room, bedroom" |
| Color accuracy note | product.color_note | "colors may vary slightly from screen display" |
Beauty and Skincare
| Attribute | Metafield Key | Example Value |
|---|---|---|
| Full ingredient list | composition.inci | INCI format ingredient list |
| Key actives | composition.actives | "2% salicylic acid, 5% niacinamide" |
| Skin type | suitability.skin_type | "oily, combination" |
| Skin concern | suitability.concern | "acne, enlarged pores" |
| Fragrance | properties.fragrance | "fragrance-free" or fragrance name |
| Cruelty-free | certifications.cruelty_free | "Leaping Bunny certified" |
| Vegan | certifications.vegan | "true" |
| SPF | specifications.spf | "SPF 50" |
| Volume/size | specifications.volume | "50ml" |
| Dermatologist tested | certifications.derm_tested | "dermatologist tested" |
Bulk Implementation Strategy
For stores with large catalogs, completing all metafields manually is not practical. A bulk approach:
Step 1: Export your product catalog from Shopify (Products > Export)
Step 2: Add metafield columns to the spreadsheet. Shopify accepts metafields in the format metafields.namespace.key in CSV import files.
Step 3: Fill in attribute values for your top 50 products manually (or with a team)
Step 4: Use Shopify's bulk import to push the completed data
Step 5: Verify a sample of 10 products in Shopify admin to confirm the metafields are correctly stored
Step 6: Repeat for the next tier of products
Frequently Asked Questions
Do all attributes need to be in metafields, or is the product description enough?
For AI agent discoverability, metafields and schema are the reliable paths. Descriptions can supplement, but agents that filter by attribute do so against structured fields, not prose.
How specific do attribute values need to be?
Match specificity to what users ask. "Waterproof" as a metafield value is useful. "GORE-TEX waterproofing with seam sealing" is more specific and matches more specific queries. When in doubt, be more specific.
What namespace should I use for metafields?
Use descriptive, consistent namespaces. specifications, materials, dimensions, certifications, and use are clean namespaces that make API queries intuitive. Avoid generic namespaces like custom which obscure the attribute's purpose.
Will completing metafields slow down my store?
No. Metafields are database values stored separately from the storefront rendering. Displaying them on product pages requires theme code, but storing them has no performance impact.
Should I display metafields on the product page for human visitors too?
Yes, if the attribute is useful to buyers. A specifications table showing material, dimensions, and compatibility serves both human visitors and AI agents, and typically improves conversion rate.
Attribute Completion Is the Work
There is no shortcut to AI agent discoverability that bypasses product data quality. The stores that appear in AI shopping recommendations are the stores with complete, structured, accurate product data.
The work is operational: audit your top products, identify attribute gaps, fill them systematically. It is not glamorous. It compounds significantly.
If you want a structured approach to your catalog's attribute coverage, our Store Health Audit includes a product data assessment.
Meta Title: Shopify Product Data for AI Agents: Attribute Guide | BoltRamp
Meta Description: Which product attributes to complete in Shopify for AI agent discoverability, by category: apparel, electronics, bags, food, home, and beauty.
Primary Keyword: Shopify product data AI agents
Secondary Keywords: Shopify product attributes, AI agent product data, Shopify metafields guide
URL Slug: /blog/shopify-product-data-ai-agents
Word Count: ~1,800
Ready to take action?
Fixed price, no surprises. Order directly or get in touch.