Preview says agents get full HTML

The amber verdict means the gateway didn’t answer on that URL — not installed, not covering that route, or (on Shopify) you previewed the wrong path.

“Agents currently get your full HTML — install the gateway to serve them clean markdown” means the agent-side request came back as ordinary HTML. The common causes, in order:

Likely causes

  • The gateway isn’t installed yet — see “Install the gateway on your store.”
  • It’s installed, but not on that route. The integration declares which paths it fronts (typically products, policies, and collections) — a URL outside those paths passes through to HTML by design.
  • The URL isn’t one the gateway has data for. The gateway renders from your product/policy/catalog sources; a page none of them match (your homepage, a blog post) passes through.
  • Shopify app-proxy installs serve agents on the proxy path: preview https://yourstore.com/apps/rebilder/products/…, not the canonical product URL. The canonical URL showing HTML on both sides is expected on Shopify.
  • A data source failed for that URL. The gateway is deliberately fail-safe: if rendering markdown fails, the request falls through to your normal HTML rather than erroring — so a broken source looks like “agents get HTML,” never a broken store.