AI shopping agents discover your products through your Shopify Catalog. To make sure they read your optimized Agentic Product Listings (APLs) instead of your default catalog data, you map each Shopify catalog field to the matching AgentIQ source. This is the crucial step that tells Shopify to send agents to your APLs — and it's a one-time setup. Once it's saved, every APL you create flows through the same mapping automatically.
Before You Begin
You'll need at least one Agentic Product Listing. The AgentIQ source values won't appear in the mapping screen until an APL exists.
Step 1: Open an Agentic Product Listing
In AgentIQ, open My Store, pick a product from your catalog and open its Agentic Product Listing. If you haven't created one yet, click Agentic Listing and follow the in-app instructions to generate it.
Your Human-Facing Page Stays the Same
Editing an Agentic Product Listing does not affect your human-facing product pages. The APL is what's surfaced to AI shopping agents — your Shopify product page is unchanged.
Step 2: Open Product Mapping
On the APL, find the Enable product mapping banner at the top of the page. This is the step that lets Shopify know to send agents to your APLs. Expand the banner and click Set up product mapping. This opens the Shopify Catalog Mapping screen.
Step 3: Map Each Field to Its AgentIQ Source
In the Product fields section you'll see Product title, Product description and Product category, each paired with a Source. By default the source is the native Shopify field. Open the Source dropdown on each row and choose the matching AgentIQ value instead:
Shopify standard field | Source to select |
Product title | AgentIQ Title |
Product description | Agentic Description |
Product category | AgentIQ Category |
As you change each source, the Product summary panel on the right previews the value that will be used, so you can confirm the agent-optimized version is the one being surfaced.
About the "Missing Field" Note
A note such as "74 of 122 active products missing field" means some products don't have an APL for that field yet. The mapping still applies — those products fall back to their native Shopify value until you generate Agentic Product Listings for them.
Step 4 (Optional): Custom Variant Grouping
Use Custom variant grouping only if you've set up a custom grouping identifier to combine products that are the same item into one listing with different options like color and size. If grouped products don't create unique combinations, grouping can fail and Shopify will show them as separate listings. Most stores can leave this off.
Step 5: Save
Don't forget to click Save in the bar at the top of the screen to apply the mapping.
What Happens Next
That's it — you're all set. From this point on, AI shopping agents querying your store see the title, description and category from your Agentic Product Listings — the version optimized for agent ingestion — instead of your raw catalog values. You only do this mapping once. New APLs you create flow through the same mapping automatically, with no need to repeat this setup.