Product Narratives
Product narratives let you write detailed, AI-optimized context for each product in your catalog. This data is injected into MCP responses when AI agents query your store.
Narrative Fields
Section titled “Narrative Fields”Each product can have the following narrative fields:
| Field | Description | Example |
|---|---|---|
| Narrative | Main product description for AI agents | ”A heavyweight Oxford cotton shirt in classic navy. True-to-size, pre-shrunk, suitable for office and casual wear.” |
| Fit notes | Sizing and fit guidance | ”Slim fit. Size up if you prefer a relaxed look. Chest runs true, sleeves slightly long.” |
| Materials | Composition and care | ”100% premium Oxford cotton, 140gsm. Machine wash cold, tumble dry low.” |
| Use cases | When and how to use | ”Business casual, smart casual, weekend brunch. Layer under blazers or wear standalone.” |
| Comparison notes | How it compares to alternatives | ”Heavier weight than our linen shirts. Similar fit to the Everyday Tee but more structured.” |
| Complementary products | What pairs well | ”Pairs well with our Slim Chinos and the Leather Weekender bag.” |
| Agent keywords | Search terms to trigger collection matching | ”oxford, business casual, cotton shirt, office wear” |
How Narratives Are Used
Section titled “How Narratives Are Used”When the MCP Enrichment Proxy (Pro) processes a product result, it looks up the product’s narrative data and appends it as a bot_it_context field in the response. AI agents see this alongside the standard Shopify product data.
Writing Effective Narratives
Section titled “Writing Effective Narratives”- Write for an AI agent, not a human shopper. Agents need structured, factual context to make recommendations.
- Fill in all relevant fields. More context means better recommendations.
- Use the agent keywords field to help Bot It match collection narratives to search queries.
- Focus on your best sellers first. You can always come back to fill in the rest.
Automatic Sync
Section titled “Automatic Sync”When you create or delete a product in Shopify, Bot It automatically creates or removes the corresponding narrative record via webhooks.
Plan Availability
Section titled “Plan Availability”Unlimited product narratives are available on all plans, including Free.