{
 "version": "1",
 "collection": "recipes",
 "about": "Step-by-step fixes for one AgentScore check on one store platform.",
 "updated": "2026-11-12",
 "count": 10,
 "items": [
  {
   "id": "shopify/readability.product-data",
   "url": "https://ghostagentlab.com/learn/fixes/shopify/#readability-product-data",
   "platform": "Shopify",
   "check": "readability.product-data",
   "title": "Give agents your price and stock on Shopify",
   "summary": "AI shopping agents read price, currency and stock from the structured data in your product pages. If any is missing, they can't say what an item costs or whether you have it. On Shopify, your theme decides this. Make sure your product template uses Liquid's structured_data filter, or outputs its own, with all three values.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "Open a product page, choose View Page Source, and search for application/ld+json to see what your theme outputs today.",
    "Check whether your product template uses Liquid's structured_data filter, which outputs a Product, or a ProductGroup for products with variants.",
    "If the template outputs its own data instead, confirm the offer gives a price, a currency and availability.",
    "Fill any gaps in the product template, generating values from the same product data the page shows so they stay current.",
    "Make sure every value matches what a shopper sees on the page, including the variant a visitor lands on."
   ],
   "verify": [
    "View the source of two or three product pages and find price, priceCurrency and availability in the JSON-LD.",
    "Paste a product URL into the Schema Markup Validator to check the markup is valid.",
    "Rescan with AgentScore and confirm the product data check passes."
   ],
   "watchOut": "Theme updates and new apps are where these problems usually come from, so rescan after you install or update either.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/shopify/",
    "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
    "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
    "https://ghostagentlab.com/articles/machine-readable-prices/"
   ],
   "sources": [
    {
     "title": "Liquid filters: structured_data",
     "publisher": "Shopify",
     "url": "https://shopify.dev/docs/api/liquid/filters/structured_data"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "shopify/readability.consistency",
   "url": "https://ghostagentlab.com/learn/fixes/shopify/#readability-consistency",
   "platform": "Shopify",
   "check": "readability.consistency",
   "title": "Make price and stock agree everywhere on Shopify",
   "summary": "Agents read your price from your product data, the page and its sharing tags. When these disagree, assistants quote the wrong price or the wrong stock. On Shopify, apps that change prices, currencies or stock badges with JavaScript are a common cause. Generate every copy from the same product data so one change updates them all.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "Pick five products and compare name, price and stock in the visible page, the JSON-LD in the page source, and the page's sharing tags.",
    "List the apps that change prices, currencies or stock badges, and check whether they do it with JavaScript after the page loads.",
    "Where an app changes the page but not the HTML, ask its developer or yours to put the same value in the HTML your server sends.",
    "Replace any hard-coded JSON-LD in your theme with data generated from the product, for example with Liquid's structured_data filter.",
    "If you sell through Shopify's agentic channels, check your catalog data and product pages say the same thing."
   ],
   "verify": [
    "View the source of a product page and confirm the JSON-LD price and availability match what the page shows.",
    "Change a test product's price and check the page, its JSON-LD and its sharing tags all update together.",
    "Rescan with AgentScore and confirm the consistency check passes."
   ],
   "watchOut": "Shopify says AI channels can still reach your product information through web crawling, which it warns might not always be as complete, accurate or up to date, so your pages must agree with your catalog.",
   "basedOn": [
    "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
    "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
    "https://ghostagentlab.com/articles/machine-readable-prices/",
    "https://ghostagentlab.com/articles/product-feeds-ai-shopping/"
   ],
   "sources": [
    {
     "title": "Liquid filters: structured_data",
     "publisher": "Shopify",
     "url": "https://shopify.dev/docs/api/liquid/filters/structured_data"
    },
    {
     "title": "Agentic storefronts: data and privacy",
     "publisher": "Shopify",
     "url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/data-privacy"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "shopify/access.guest-checkout",
   "url": "https://ghostagentlab.com/learn/fixes/shopify/#access-guest-checkout",
   "platform": "Shopify",
   "check": "access.guest-checkout",
   "title": "Let shoppers check out as guests on Shopify",
   "summary": "An AI agent buying for someone can't create an account for them, so a forced sign-in stops the order at the last step. Shopify hosts your checkout, and one setting matters most. In Settings > Checkout, leave \"Require sign-in before checkout\" off unless you truly need customer accounts.",
   "owner": "E-commerce platform admin",
   "effort": "Days",
   "steps": [
    "In your Shopify admin, go to Settings > Checkout and find the setting to require sign-in before checkout.",
    "Turn it off unless your business truly needs accounts, for example trade-only or subscription sales.",
    "Read your cart page as an agent would, and remove any theme or app text saying shoppers must sign in to check out.",
    "Offer accounts after the order, for example a \"Save your details for next time\" prompt on the confirmation page.",
    "If you must keep accounts, say so on product pages and in your llms.txt so agents can tell the shopper early."
   ],
   "verify": [
    "Open your store in a private window, add a product to the cart, and press checkout. You should reach a contact and delivery form with no password field.",
    "Rescan with AgentScore and confirm the guest checkout check passes."
   ],
   "watchOut": "Shopify's spam protection adds hCaptcha to legacy customer account login and sign-up pages by default, so make sure shoppers never need those pages to buy.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/shopify/",
    "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
    "https://ghostagentlab.com/articles/guest-checkout-ai-agents/"
   ],
   "sources": [
    {
     "title": "Checkout form options",
     "publisher": "Shopify",
     "url": "https://help.shopify.com/en/manual/checkout-settings/checkout-form-options"
    },
    {
     "title": "Online store preferences (spam protection)",
     "publisher": "Shopify",
     "url": "https://help.shopify.com/en/manual/online-store/setting-up/preferences"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "shopify/access.robots",
   "url": "https://ghostagentlab.com/learn/fixes/shopify/#access-robots",
   "platform": "Shopify",
   "check": "access.robots",
   "title": "Let AI assistants in through robots.txt on Shopify",
   "summary": "If robots.txt shuts out AI assistants and AI search, they can't read your pages and leave you out of their answers. Shopify's default robots.txt lets AI agents in. Problems come from a robots.txt.liquid template someone added to your theme. Open /robots.txt and remove any rules blocking assistants such as ChatGPT-User or Claude-User.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "steps": [
    "Open yourstore.com/robots.txt and read every group, noting which agent names each applies to.",
    "Look for Disallow rules naming AI assistants or AI search agents, such as ChatGPT-User, Claude-User or OAI-SearchBot.",
    "If your theme has a robots.txt.liquid template, remove those rules there, adding or removing rules with Liquid on top of Shopify's defaults.",
    "Avoid replacing the template with plain text, so Shopify can keep updating the defaults.",
    "Leave the default rules for cart and checkout alone. They don't cost you in AgentScore."
   ],
   "verify": [
    "Reload /robots.txt and confirm no group blocks AI assistants or AI search agents from your product pages.",
    "Rescan with AgentScore and confirm the robots.txt check passes."
   ],
   "watchOut": "Shopify notes that an older robots.txt.liquid template can output rules the current default no longer has, so compare yours with the current default.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/shopify/",
    "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
    "https://ghostagentlab.com/articles/robots-txt-ai-agents/"
   ],
   "sources": [
    {
     "title": "Editing robots.txt",
     "publisher": "Shopify",
     "url": "https://help.shopify.com/en/manual/promoting-marketing/seo/editing-robots-txt"
    },
    {
     "title": "robots.txt.liquid template",
     "publisher": "Shopify",
     "url": "https://shopify.dev/docs/storefronts/themes/architecture/templates/robots-txt-liquid"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "shopify/readability.prices",
   "url": "https://ghostagentlab.com/learn/fixes/shopify/#readability-prices",
   "platform": "Shopify",
   "check": "readability.prices",
   "title": "Put prices in the page HTML on Shopify",
   "summary": "Most AI assistants read the HTML your server sends and never run JavaScript. If a price only appears after scripts run, they see a product with no price and often skip it. On Shopify, apps that change prices or currencies with JavaScript can cause this. Make sure your theme puts each price in the HTML.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "Open a product page, choose View Page Source (not Inspect), and search for the price.",
    "If it's missing, find the theme section or app that fills it in after the page loads.",
    "Ask your developer to output the price in the theme's HTML and let JavaScript update it only when a shopper changes options.",
    "Show a currency code where the symbol could be unclear, such as \"$18.00 USD\".",
    "Label sale prices in words, such as \"Was $24.00, now $18.00\", and list variant prices in the option labels."
   ],
   "verify": [
    "View the source of a product page and a sale product, and find each price with its currency.",
    "Rescan with AgentScore and confirm the prices check passes."
   ],
   "watchOut": "Apps that change prices, currencies or stock badges with JavaScript can leave the HTML saying one thing and the page another, so recheck the source after installing one.",
   "basedOn": [
    "https://ghostagentlab.com/blog/agent-readiness-for-shopify-stores/",
    "https://ghostagentlab.com/articles/machine-readable-prices/"
   ],
   "sources": [],
   "reviewed": "2026-11-12"
  },
  {
   "id": "woocommerce/readability.product-data",
   "url": "https://ghostagentlab.com/learn/fixes/woocommerce/#readability-product-data",
   "platform": "WooCommerce",
   "check": "readability.product-data",
   "title": "Give agents your price and stock on WooCommerce",
   "summary": "AI shopping agents read price, currency and stock from the structured data in your product pages. Without them, assistants can't say what an item costs or whether it's in stock. WooCommerce outputs a Product block as JSON-LD, and SEO plugins often add a second one. Keep one block that carries all three values.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "Open a product page, choose View Page Source, and search for application/ld+json.",
    "Count the Product blocks. WooCommerce outputs one, and SEO plugins often add their own.",
    "If there are two, decide with your developer which one to keep, and turn off the other in the plugin or theme.",
    "Confirm the remaining block's offer gives a price, a currency and availability.",
    "Check variable products too. Where prices differ by size or color, ask your developer to describe each variant with its own offer.",
    "Make sure every value matches the visible page."
   ],
   "verify": [
    "View the source of a simple product and a variable product, and find one Product block with price, priceCurrency and availability.",
    "Paste a product URL into the Schema Markup Validator to check the markup is valid.",
    "Rescan with AgentScore and confirm the product data check passes."
   ],
   "watchOut": "For variable products, WooCommerce core outputs a single aggregated block with a price range, so agents don't see each variation's price from it.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/woocommerce/",
    "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
    "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
    "https://ghostagentlab.com/articles/machine-readable-prices/"
   ],
   "sources": [
    {
     "title": "Say hello to WooCommerce 3.0 (product data as JSON-LD)",
     "publisher": "WooCommerce",
     "url": "https://developer.woocommerce.com/2017/04/04/say-hello-to-woocommerce-3-0-bionic-butterfly/"
    },
    {
     "title": "Google Product Feed: expanded structured data",
     "publisher": "WooCommerce",
     "url": "https://woocommerce.com/document/google-product-feed-expanded-structured-data/"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "woocommerce/readability.consistency",
   "url": "https://ghostagentlab.com/learn/fixes/woocommerce/#readability-consistency",
   "platform": "WooCommerce",
   "check": "readability.consistency",
   "title": "Make price and stock agree everywhere on WooCommerce",
   "summary": "Agents read your price from your product data, the page and its sharing tags. When these disagree, assistants quote the wrong price or say an item is in stock when it isn't. On WooCommerce, the usual cause is two structured data blocks, one from WooCommerce and one from an SEO plugin. Keep one, generated from live product data.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "View the source of a product page and count the Product blocks. WooCommerce outputs one, and SEO plugins often add another.",
    "Compare price, currency, stock and name across each block, the visible page and the page's sharing tags.",
    "Keep one Product block, and turn off the duplicate in the SEO plugin or theme that adds it.",
    "Remove any hand-written or hard-coded JSON-LD so every value comes from the same product record.",
    "Check currency switchers and dynamic pricing plugins put the same price in the HTML that the page shows."
   ],
   "verify": [
    "View the source of five product pages and confirm one Product block whose price and availability match the page.",
    "Change a test product's price and check the page and its JSON-LD update together.",
    "Rescan with AgentScore and confirm the consistency check passes."
   ],
   "watchOut": "For variable products, WooCommerce core outputs one aggregated block with a price range, so check that range matches the prices the page shows.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/woocommerce/",
    "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
    "https://ghostagentlab.com/articles/structured-data-ai-shopping-agents/",
    "https://ghostagentlab.com/articles/machine-readable-prices/",
    "https://ghostagentlab.com/articles/product-feeds-ai-shopping/"
   ],
   "sources": [
    {
     "title": "Google Product Feed: expanded structured data",
     "publisher": "WooCommerce",
     "url": "https://woocommerce.com/document/google-product-feed-expanded-structured-data/"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "woocommerce/access.guest-checkout",
   "url": "https://ghostagentlab.com/learn/fixes/woocommerce/#access-guest-checkout",
   "platform": "WooCommerce",
   "check": "access.guest-checkout",
   "title": "Let shoppers check out as guests on WooCommerce",
   "summary": "An AI agent buying for someone can't create an account for them, so a forced account stops the order at the last step. WooCommerce has a setting for this. In WooCommerce > Settings > Accounts and Privacy, turn on \"Enable guest checkout\", and offer account creation after checkout if you want accounts.",
   "owner": "E-commerce platform admin",
   "effort": "Days",
   "steps": [
    "Go to WooCommerce > Settings > Accounts and Privacy.",
    "Turn on \"Enable guest checkout\" unless your business truly needs accounts.",
    "If you offer accounts, use the \"After checkout\" account creation option so buyers can create one once the order is placed.",
    "Read your cart page as an agent would, and remove any theme or plugin text saying shoppers must sign in to check out.",
    "Check no plugin adds a CAPTCHA to every order, whichever checkout you run, block or classic."
   ],
   "verify": [
    "Open your store in a private window, add a product to the cart, and press checkout. You should reach a contact and delivery form with no password field.",
    "Rescan with AgentScore and confirm the guest checkout check passes."
   ],
   "watchOut": "WooCommerce notes that subscription purchases still require an account, so say so on those product pages so agents can tell the shopper up front.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/woocommerce/",
    "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
    "https://ghostagentlab.com/articles/guest-checkout-ai-agents/"
   ],
   "sources": [
    {
     "title": "Accounts and Privacy settings",
     "publisher": "WooCommerce",
     "url": "https://woocommerce.com/document/configuring-woocommerce-settings/accounts-and-privacy/"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "woocommerce/access.robots",
   "url": "https://ghostagentlab.com/learn/fixes/woocommerce/#access-robots",
   "platform": "WooCommerce",
   "check": "access.robots",
   "title": "Let AI assistants in through robots.txt on WooCommerce",
   "summary": "If robots.txt shuts out AI assistants and AI search, they can't read your pages and leave you out of their answers. WordPress generates robots.txt, and SEO plugins often take it over and may add AI rules without anyone noticing. Find which plugin controls the file, then remove rules blocking assistants such as ChatGPT-User or Claude-User.",
   "owner": "SEO or content team",
   "effort": "Hours",
   "steps": [
    "Open yourstore.com/robots.txt and read every group, noting which agent names each applies to.",
    "Find out which plugin is in charge of the file before changing anything. WordPress generates it, and SEO plugins often take it over.",
    "Look for Disallow rules naming AI assistants or AI search agents, such as ChatGPT-User, Claude-User or OAI-SearchBot.",
    "Remove those rules in the plugin or code that adds them. Blocking only training crawlers is a business choice you can keep.",
    "If you add a group for one agent, copy into it every rule you want it to follow."
   ],
   "verify": [
    "Reload /robots.txt and confirm no group blocks AI assistants or AI search agents from your product pages.",
    "Rescan with AgentScore and confirm the robots.txt check passes."
   ],
   "watchOut": "Plugins and themes can change robots.txt through WordPress's robots_txt filter, so a blocking rule may come from a plugin or theme you didn't expect.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/woocommerce/",
    "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
    "https://ghostagentlab.com/articles/robots-txt-ai-agents/"
   ],
   "sources": [
    {
     "title": "robots_txt hook",
     "publisher": "WordPress",
     "url": "https://developer.wordpress.org/reference/hooks/robots_txt/"
    }
   ],
   "reviewed": "2026-11-12"
  },
  {
   "id": "woocommerce/readability.prices",
   "url": "https://ghostagentlab.com/learn/fixes/woocommerce/#readability-prices",
   "platform": "WooCommerce",
   "check": "readability.prices",
   "title": "Put prices in the page HTML on WooCommerce",
   "summary": "Most AI assistants read the HTML your server sends and never run JavaScript. If a price only appears after scripts run, they see a product with no price and often skip it. On WooCommerce, currency switchers and dynamic pricing plugins sometimes fill prices in with JavaScript. Check prices are in the HTML your server sends.",
   "owner": "Developer",
   "effort": "Days",
   "steps": [
    "Open a product page, choose View Page Source (not Inspect), and search for the price.",
    "If it's missing, check your currency switcher and dynamic pricing plugins, which sometimes fill prices in with JavaScript.",
    "Ask your developer or the plugin's vendor to output the price in the HTML and update it with JavaScript only when a shopper changes options.",
    "Show a currency code where the symbol could be unclear, such as \"$18.00 USD\".",
    "Label sale prices in words, such as \"Was $24.00, now $18.00\", and list variant prices in the option labels."
   ],
   "verify": [
    "View the source of a product page and a sale product, and find each price with its currency.",
    "Rescan with AgentScore and confirm the prices check passes."
   ],
   "watchOut": "If a currency switcher changes the currency by visitor location, an agent may see a different currency from its user, so give each currency a stable URL or a visible switcher.",
   "basedOn": [
    "https://ghostagentlab.com/platforms/woocommerce/",
    "https://ghostagentlab.com/blog/agent-readiness-for-woocommerce-stores/",
    "https://ghostagentlab.com/articles/machine-readable-prices/"
   ],
   "sources": [],
   "reviewed": "2026-11-12"
  }
 ]
}
