Skip to content

Agentic

External product URL field: who needs it and why

Published

What the external product URL field is

External product URL is a product-level field on Shopify Agentic-plan stores that points to the canonical product page on the merchant's existing (non-Shopify) storefront. It's how the AI channel deep-links a product card back to where the merchant actually wants the buyer to land. Full Shopify online-store plans don't have it because they use the Shopify-hosted product URL automatically.

The field is documented on the Catalog requirements page2 and the optimizing-products doc1. Catalog eligibility on the Agentic plan requires the field on every product.

When the field is required

Only on Agentic-plan stores. The Catalog requirements page lists it as a sub-clause under the products-published-to-channels gate: 'Agentic plan users must include external product URL.' Stores on Basic / Shopify / Advanced / Plus plans use the Shopify-hosted product URL automatically and don't see this field.

If you're on a full online-store plan and don't see the field in your admin, that's expected. It only appears on Agentic-plan products.

What happens if it's missing on Agentic-plan products

Catalog eligibility fails for that product. The product won't be syndicated to AI channels because the AI channel has no canonical URL to deep-link to. In ChatGPT (referrer model) the lack of a destination URL is fatal — the channel can't surface the product card without somewhere to send the buyer. In Copilot / Gemini / Perplexity / Shop (direct-checkout channels), the in-chat checkout could theoretically complete without the external URL, but Shopify still requires the field because the channel may want to surface the product card with a 'View on merchant's site' link.

Field-setting checklist

Walk these five steps when setting up an Agentic-plan store. The field is per-product, so a bulk approach is necessary at any non-trivial catalog size. Most Agentic-plan stores use a CSV import with the external URL column mapped, or an API-driven sync from their existing PIM.

  1. Identify the canonical product URL for each product on your existing storefront.
  2. If using CSV import: add an external_product_url column and map it during import.
  3. If using the Admin API: include the external_product_url field in your product mutation.
  4. Confirm the URL is publicly accessible (no login wall, no geo restriction blocking US/CA traffic).
  5. Confirm the URL renders fast and matches the Shopify Catalog product (same title, image, price) so the AI channel doesn't flag inconsistency.

Keep reading