Metafields & Syndication
How Vantage metafields are structured, stored, and syndicated to AI shopping platforms
Last updated: 6th June 2026
Metafields & Syndication
Vantage writes structured data directly to your Shopify product metafields. These metafields are included in Shopify's Catalog syndication to AI platforms, making your product quality signals visible to AI shopping agents.
The vantage namespace
All Vantage metafields use the app-reserved vantage namespace. App-reserved namespaces are owned by the app, so these metafields stay organized and separate from metafields created by other apps or your own custom definitions, and only Vantage can write to them.
Metafields written today (MVP)
Vantage currently writes two metafields per product after each audit:
| Metafield | Type | Description |
|---|---|---|
vantage.ai_readiness_score | Integer (0-100) | The composite AI readiness score across all 9 dimensions |
vantage.last_optimized | DateTime | Timestamp of the most recent audit |
These are written automatically after every audit, unless you've disabled metafield writing in Settings.
Metafields reserved for Phase 2
Vantage registers 10 metafield definitions on install. Eight are reserved for upcoming features that will provide AI-optimized product content:
| Metafield | Type | Purpose |
|---|---|---|
vantage.ai_title | Single-line text | AI-optimized product title |
vantage.ai_description | Multi-line text | AI-optimized product description |
vantage.key_features | List (text) | Key product features as a structured list |
vantage.use_cases | List (text) | Target use cases |
vantage.materials | Single-line text | Material composition |
vantage.certifications | List (text) | Certifications and compliance |
vantage.target_audience | Single-line text | Intended demographic |
vantage.comparison_attrs | JSON | Structured comparison data |
These reserved metafields are defined but not written to in the current version. When Phase 2 launches, Vantage will populate them with AI-generated, optimized product content.
How syndication works
The pipeline from Vantage to AI shopping agents looks like this:
- Vantage audits your product and calculates the AI readiness score
- Score is written to the
vantage.ai_readiness_scoremetafield on the Shopify product - Shopify Catalog syndication picks up the metafield because it's registered with
PUBLIC_READaccess andPRODUCTowner type - AI platforms receive the data through Shopify's feeds and the Universal Commerce Protocol
- AI agents see your score as a quality signal when evaluating your product
Why this matters
AI agents making product recommendations need quality signals. A product with a high AI readiness score and well-structured metafield data sends a clear signal: this product has complete, accurate, structured information that can be trusted.
The score itself may be used by AI platforms as one factor in recommendation decisions. More importantly, the metafield infrastructure Vantage sets up ensures that when Phase 2 adds AI-optimized titles, descriptions, and attributes, all of that data flows directly into AI platform feeds.
Metafield technical details
- Ownership: App-owned (only Vantage can modify these metafields)
- Access level:
PUBLIC_READon storefront, enabling Shopify Catalog syndication - Owner type:
PRODUCT(metafields are attached to individual products) - Write timing: Metafields are written per product immediately after each audit — a single update per product covering both fields
Controlling metafield writing
Metafield writing is enabled by default. Your AI readiness score is automatically written to each product after every audit. You can toggle this off in Settings if you prefer to audit without writing data to your products.
What happens on uninstall
When you uninstall Vantage, the app removes all of its metafield definitions and their associated values from your products. Because these live in the app-reserved vantage namespace, they are owned by Vantage — uninstalling the app deletes the definitions and the AI readiness scores written to your products. You don't need to clean anything up manually.
If you reinstall Vantage later, it re-registers the definitions on install and rewrites the scores on the next audit.
Next steps
- Metafield Writing Settings — Enable, disable, or configure metafield behavior
- Troubleshooting Metafield Issues — Common metafield problems and solutions