UCP is an actively evolving protocol — capabilities, naming, and merchant onboarding processes may change. This checklist reflects the state of the specification as of May 2026 (version 2026-04-08). We update this guide when the spec changes.

UCP Readiness Checklist for Magento 2 — 10 steps from default installation to AI agent commerce readiness
10 steps from default Magento 2 installation to UCP-ready AI agent commerce

TL;DR — 2 minute version

  • UCP readiness is not just installing a module — it requires AEO foundations first (robots.txt, llms.txt, schema, feed)
  • Steps 1–4 are AEO foundations that also benefit Google Search, ChatGPT, and Perplexity visibility
  • Steps 5–8 are UCP-specific: module installation, key generation, profile enablement, verification
  • Steps 9–10 are optimisation: FAQ schema and a full AEO audit
  • Estimated total time: 4–6 hours (excluding OpenAI’s ACP feed approval timeline)
  • UCP discovery ≠ UCP recommendation. Completing this checklist makes your store findable — not automatically recommended

Universal Cart has begun rolling out in the US as of May 19, 2026. Canada and Australia are next, per Google’s announcements. The UK is expected to follow.

If your Magento store has not implemented UCP, it cannot be discovered by AI agents using the UCP protocol — which Google is deploying across Search AI Mode, Gemini, and YouTube Shopping. This does not mean your store is invisible to all AI systems — Google Merchant Center feeds, direct crawling, and schema still matter — but UCP is an additional discovery layer that is growing in importance.

This checklist covers the ten steps between a default Magento installation and a UCP-compliant store. Some take five minutes. Some take a few hours. All steps can be implemented on your existing Magento installation.

This guide is part of the Merchant-Controlled AEO architecture. For a plain-English explanation of what UCP is and why it matters, see What Is UCP? A Store Owner’s Guide.

Before UCP: the foundation (Steps 1–4)

UCP is the roof. These four steps are the foundation. Without them, UCP has nothing to build on — a UCP profile without indexed content and structured product data is a door with nothing behind it.

These steps also improve your visibility in Google Search, ChatGPT, Perplexity, and Claude — they are valuable regardless of whether you implement UCP.

Step 1 — Unblock AI crawlers in robots.txt

Time: 5 minutes
Why it matters: AI agents and crawlers need permission to access your store. Magento’s default robots.txt blocks most of them.

Open yourstore.com/robots.txt and verify that these bots are explicitly allowed:

# Required for AI commerce visibility User-agent: OAI-SearchBot Allow: / User-agent: Googlebot Allow: / User-agent: Google-Extended Allow: /

OAI-SearchBot is ChatGPT’s search indexer. Google-Extended is used by Gemini. Both need access for their respective commerce protocols to function.

If any of these appear under a Disallow: / directive, fix it before proceeding. Everything else in this checklist is irrelevant if crawlers cannot reach your store.

Step 2 — Generate llms.txt

Time: 10 minutes (automated)
Why it matters: llms.txt tells AI systems what your store sells, in plain language. Without it, AI agents construct an approximate — and often inaccurate — model of your business.

composer require angeo/module-llms-txt bin/magento module:enable Angeo_LlmsTxt bin/magento setup:upgrade

The module generates both llms.txt and llms.ljson from your live catalog automatically. Cron-scheduled to update when products change.

Verify: visit yourstore.com/llms.txt — you should see a structured summary of your store, categories, and key products.

Step 3 — Implement Product JSON-LD schema

Time: 1–2 hours
Why it matters: AI agents — and UCP specifically — rely on structured product data. JSON-LD is the format both Google and OpenAI prefer. Magento’s default uses microdata, which is less reliable for AI parsing.

Critical fields to include:

FieldWhy it matters
nameProduct name — used as the primary identifier
descriptionProduct description — AI agents read this to form recommendations
offers.priceCurrent price — required for shopping comparisons
offers.priceCurrencyCurrency code — ambiguous pricing breaks AI agent trust
offers.availabilityMost common failure. ChatGPT Shopping and UCP both skip products without confirmed availability
skuProduct identifier — used for cross-platform matching
aggregateRatingReview score — affects recommendation confidence (if you have reviews)
The single most common failure: offers.availability missing. This one field determines whether AI agents consider your product purchasable. Without it, your products may be skipped entirely — regardless of how complete the rest of your schema is.

Step 4 — Submit product feed for ChatGPT Shopping

Time: 30 minutes + 1–4 weeks approval
Why it matters: ACP and UCP serve different platforms but share the same foundation. A submitted product feed makes your products available for ChatGPT Shopping consideration. The product data you prepare — prices, availability, descriptions — is the same data UCP needs.

composer require angeo/module-openai-product-feed bin/magento module:enable Angeo_OpenaiProductFeed bin/magento setup:upgrade

Submit your feed through chatgpt.com/merchants. Approval typically takes one to four weeks. Note: OpenAI has not published a stable, widely-documented merchant onboarding standard as of May 2026 — treat the submission process as evolving.

UCP implementation (Steps 5–8)

With the foundation in place, your store is ready for UCP. These steps add the protocol-specific discovery layer.

Step 5 — Install the UCP profile module

Time: 10 minutes
Why it matters: This is the discovery layer — the file at /.well-known/ucp that tells AI agents your store exists and what capabilities it supports.

# Requires Magento 2.4.7+, PHP 8.2+, OpenSSL extension composer require angeo/module-ucp:^0.1@beta bin/magento module:enable Angeo_Ucp bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush

Step 6 — Generate ECDSA signing keys

Time: 5 minutes
Why it matters: UCP requires cryptographic signing keys for secure communication between your store and AI agents. The module generates ECDSA P-256 keys — the same standard used by Apple Pay and Google Pay.

bin/magento angeo:ucp:keys:generate

The command prints the private PEM key to your terminal exactly once. Copy it immediately into app/etc/env.php:

// app/etc/env.php ‘ucp’ => [ ‘signing_keys’ => [ ‘angeo-ucp-2026-abcd’ => ‘<YOUR PRIVATE PEM HERE>’, ], ],

The public JWK is saved to Magento config automatically. The private key never touches the database.

Step 7 — Enable the UCP profile

Time: 2 minutes
Why it matters: The module installs disabled by default. You need to explicitly opt in.

Navigate to: Stores → Configuration → Angeo → UCP → General → Advertise UCP Profile: Yes

For v0.1.x (profile-only release), leave all individual capabilities disabled — the profile establishes your presence in the UCP discovery layer while actual endpoints are developed in later versions.

v0.1.x note: Enabling a capability in the admin panel adds it to the advertised profile — but the matching REST endpoint does not exist yet in this release. Leave capabilities disabled until the corresponding endpoint module is available and tested.

Step 8 — Verify the profile

Time: 2 minutes
Why it matters: A malformed profile is worse than no profile — it signals to AI agents that your store is unreliable.

# Fetch and validate your UCP profile curl -s https://yourstore.com/.well-known/ucp | python3 -m json.tool

You should see a valid JSON response with version: "2026-04-08", your signing keys, and the dev.ucp.shopping service binding.

Run the built-in validator:

bin/magento angeo:ucp:validate –json

Green pass means your profile is spec-compliant. Non-zero exit means something needs fixing — the output tells you what.

External validation: You can also use ucpchecker.com to validate your profile against the official conformance test suite.

What you have after Step 8

At this point, your store has a spec-compliant UCP profile at /.well-known/ucp. AI agents that support UCP discovery can find your store and read its capabilities.

This does not mean AI agents will immediately recommend your products. UCP discovery is one layer in a stack that also includes catalog quality, pricing, schema completeness, entity authority, and feed registration. Steps 9 and 10 address the most impactful remaining signals.

Think of Steps 1–8 as infrastructure. What you build on that infrastructure — product quality, content quality, brand authority — determines the commercial outcome.

Optimisation and monitoring (Steps 9–10)

Step 9 — Add FAQPage schema to key pages

Time: 1–2 hours
Why it matters: AI agents extract FAQ content as trusted answers. Category pages and product pages with FAQ schema are more likely to be cited in AI responses — and more likely to be the source an agent references when recommending products.

Add FAQPage JSON-LD schema to:

  • Your top 10 category pages (by revenue)
  • Your top 20 product pages (by revenue)
  • Your homepage

Each FAQ section should contain 3–5 questions with direct, factual answers. Use the questions your customers actually ask — shipping times, return policies, size guides, compatibility, care instructions.

Step 10 — Run a full AEO audit

Time: 30 seconds
Why it matters: Steps 1–9 cover the individual components. The audit scores your store across all 9 AEO signals and shows where gaps remain.

# CLI audit — shows scored results for all 9 signals bin/magento angeo:aeo:audit

Or use the web-based audit — no installation required:

See exactly where the gaps are

The audit checks all 9 signals — robots.txt, llms.txt, schema, feeds, UCP profile, and more. 30 seconds.

Run free AEO audit →

Target: 85%+ AEO score with UCP profile active.

The complete picture

StepTimeImpactAlso benefits
1. robots.txt5 minPrerequisite — without this, nothing worksChatGPT, Perplexity, Claude
2. llms.txt10 minAI agents understand your store correctlyAll AI platforms
3. JSON-LD schema1–2 hrsProducts are parseable and purchasableGoogle Search, ChatGPT Shopping
4. ACP feed30 min + waitChatGPT Shopping visibilityChatGPT
5. UCP module10 minGoogle AI discovery layerUCP-specific
6. Signing keys5 minSecure agent communicationUCP-specific
7. Enable profile2 minGo live on UCPUCP-specific
8. Verify2 minConfirm spec complianceUCP-specific
9. FAQ schema1–2 hrsHigher citation rate in AI answersAll AI platforms, Google Search
10. Full audit30 secIdentify remaining gapsEverything

Total estimated time: 4–6 hours for a complete implementation, including ACP registration (excluding OpenAI’s approval timeline of 1–4 weeks).

Note the “Also benefits” column. Steps 1–4 improve your visibility across all AI platforms — not just UCP. Even if you decide to defer UCP implementation, completing Steps 1–4 makes your store more visible to ChatGPT, Perplexity, Gemini, and Claude.

What comes next

The angeo/module-ucp v0.1.x is the profile-only release — it makes your store discoverable to AI agents via the UCP standard. Further capability endpoints are planned as the UCP specification stabilises.

Planned roadmap (subject to UCP spec evolution)

The UCP specification is under active development. This roadmap reflects current planning as of May 2026 and may change as the protocol matures.

Target versionPlanned capabilityStatus
0.2.xCatalog search endpoint — AI agents can search your productsIn development
0.3.xUCP-Agent header parsing and capability negotiationPlanned
0.4.xHTTP Message Signatures (RFC 9421)Planned
0.5.xCart capabilityPlanned
1.0.0Full shopping vertical — catalog, cart, checkout, orderDependent on spec stability

Release dates are not committed. Each version will be tested against the current UCP conformance suite before release.

Each release will be announced on the angeo.dev blog and on Packagist. The module is MIT-licensed — no licensing fees, no SaaS subscriptions, no external data transmission.

Need checkout endpoints now? The gtstudio/module-ucp module includes checkout session endpoints, quote management, and UcpSession persistence in its current release. If you need functional checkout capability today rather than profile-only discovery, it may be the better fit. See its Packagist page for details. Both modules implement the same UCP specification — the difference is scope and release strategy.

Frequently asked questions FAQ schema

Technically yes — the UCP module installs independently. Practically, a UCP profile without indexed content and structured product data is a door with nothing behind it. AI agents discover your profile, find no usable catalog data, and move on. Complete Steps 1–4 first.
Steps 1–2 and 5–8 require SSH access to your Magento server and comfort with composer and bin/magento commands. If you have a development team or agency, this is routine Magento module management. Steps 3 and 9 require template modifications or a schema module. Step 10 (the audit) can be run by anyone via the web-based tool.
Not yet, per Google’s public announcements. Google has announced rollout to Canada, Australia, and the UK, with more markets to follow. Implementing now means you are ready the day your market goes live — ahead of competitors who will start from scratch.
The UCP module works alongside the existing Angeo module suite — module-aeo-audit, module-llms-txt, module-openai-product-feed, module-rich-data, and module-robots-txt-aeo. No conflicts. They share configuration conventions but operate independently.
Not in v0.1.x. The current release advertises the profile but does not implement the actual REST endpoints for catalog, cart, or checkout. Enabling a capability adds it to the advertised profile — but the matching endpoint does not exist yet. This could cause AI agents to attempt interactions your store cannot handle. Leave capabilities disabled until the corresponding endpoint module is released and tested.
No. UCP makes your store discoverable — a prerequisite, not a guarantee. Whether an AI agent recommends your products depends on catalog quality, pricing, review signals, entity authority, schema completeness, and fulfilment reliability. Completing this checklist makes you findable. Building a strong catalog, competitive pricing, and good product data makes you recommendable.


0 Comments

Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *