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. Once a store moves to a paid plan and publishes a Shopify online store, AI-channel product links point to the Shopify product pages instead.

The field is documented on the Catalog requirements page2 and the optimizing-products doc1. Catalog eligibility requires it on every product of an Agentic-plan store that hasn't published a Shopify online store.

When the field is required

On Agentic-plan stores that haven't published a Shopify online store. The Catalog requirements page puts it as a sub-clause under the products-published-to-channels gate: 'If you're using the Shopify Agentic plan and haven't published a Shopify online store, then your products must include the external product URL.' In practice that covers every store while it's on the Agentic plan, because publishing an online store needs a paid plan.

Shopify's Agentic plan page says so directly: to publish your online store "you need to move to a paid Shopify subscription plan," and your agentic storefronts product links "point to your Shopify online store only after you publish your online store"3. Once you're on a paid plan with a published store, the requirement no longer applies. Shopify's optimizing-products doc lists the field only "for stores on the Shopify Agentic plan"1.

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