How Shopify Merchants Can Enable UCP Checkout Today
A step-by-step guide for Shopify merchants to enable UCP checkout: eligibility, admin setup, manifest verification, Google Merchant Center linking, conformance testing, and troubleshooting common issues.
Why Shopify Merchants Should Care About UCP
If you run a Shopify store, UCP (Universal Commerce Protocol) is probably the most impactful new channel you can enable in 2026. AI shopping agents from Google, Anthropic, Perplexity, and others are actively routing purchase-ready consumers to UCP-enabled merchants. Early data from merchants in the beta program showed conversion rates on agent-initiated sessions running 20 to 40 percent higher than standard web checkout, because the consumer has already decided to buy before the checkout session starts.
The good news: for Shopify merchants, enabling UCP is mostly a configuration task, not an engineering project. Shopify has built UCP support directly into the platform. This guide walks through the full process from eligibility check to live agent traffic.
Step 1: Verify Eligibility
Before touching the admin panel, confirm you meet the current eligibility requirements.
Plan: UCP checkout is available on Shopify Basic, Shopify (standard), Advanced, and Plus plans. It is not available on Starter or legacy Lite plans.
Region: As of March 2026, UCP checkout is available for merchants with storefronts in the United States, Canada, United Kingdom, Australia, Germany, France, Netherlands, Sweden, and Japan. Other regions are on the roadmap but not yet supported.
Checkout type: You must be using Shopify Checkout (the hosted checkout). Custom storefront checkouts using the Storefront API require a separate implementation path using the UCP SDK directly. Headless implementations are supported but need additional configuration covered in Step 6 below.
Payment processor: Your store must use Shopify Payments, Stripe, Adyen, Braintree, or any other payment processor in the UCP-certified processor list. To check if your processor is certified, visit ucp.dev/payments. Most major processors have completed certification. PayPal is notable for being on the roadmap but not yet certified as of this writing.
If all four conditions are met, you are eligible to enable UCP.
Step 2: Enable UCP in Shopify Admin
Navigate to your Shopify Admin panel and go to Settings > Checkout. Scroll down to the section labeled Agent Commerce. You will see a toggle for Universal Commerce Protocol (UCP). Enable it.
Once enabled, you will be prompted to configure three sub-settings:
Catalog sync: Controls which products are exposed to UCP discovery endpoints. Options are "All active products," "Products with inventory tracked," or a custom collection. For most merchants, "All active products" is the right choice. If you have products that should not be purchasable through agents (wholesale-only SKUs, in-store-only items), use a custom collection.
Cart management: Determines how UCP handles cart sessions. "Managed by Shopify" uses Shopify's standard cart API and is recommended for all merchants using native Shopify Checkout. "Custom cart endpoint" is for merchants with headless setups.
Inventory visibility: Choose whether agents see real-time inventory counts or only availability (in stock/out of stock). Showing real-time counts helps agents make better recommendations when items have limited stock, but some merchants prefer not to expose exact inventory levels. Your call.
Save the settings. Shopify will now begin generating your UCP manifest, which takes up to 15 minutes to propagate.
Step 3: Verify Your .well-known/ucp Manifest
Once the manifest is generated, you can verify it by navigating to https://your-store.myshopify.com/.well-known/ucp in a browser, or using curl:
curl https://your-store.myshopify.com/.well-known/ucpA correctly configured manifest will look something like this:
{
"ucp_version": "1.2",
"merchant_id": "shopify:your-store",
"display_name": "Your Store Name",
"capabilities": ["discovery", "checkout", "order_management"],
"endpoints": {
"discovery": "https://your-store.myshopify.com/ucp/v1/discovery",
"checkout": "https://your-store.myshopify.com/ucp/v1/checkout",
"orders": "https://your-store.myshopify.com/ucp/v1/orders"
},
"payment_processors": ["shopify_payments"],
"identity_providers": ["shopify_identity", "google"],
"catalog_scope": "all_active",
"conformance_level": "standard",
"last_updated": "2026-03-26T10:00:00Z"
}Things to verify: ucp_version should be 1.2 or higher. All three endpoint URLs should return HTTP 200 when hit directly. The payment_processors array should include your active payment method. If the manifest shows conformance_level: "pending", the verification step is still running.
If the file returns a 404, wait another 10 minutes and try again. If it persists after 30 minutes, check that UCP is enabled in admin and that your store is not using a custom domain with misconfigured DNS (custom domain manifests are covered below).
Step 4: Link to Google Merchant Center
Connecting your UCP-enabled store to Google Merchant Center is what routes Google AI Mode and Google Shopping agent traffic to your store. Without this link, UCP-capable agents using Google's infrastructure will not find you.
In Google Merchant Center, go to Settings > Linked accounts > Commerce protocols. Select Add UCP merchant and enter your store's root domain. Google will verify the manifest automatically and confirm the link within a few hours.
Note: this is separate from your existing Google Shopping product feed. Your product feed continues to power standard Shopping ads. The UCP link is specifically for agent-initiated transactions through AI Mode. Both can and should be active simultaneously.
Step 5: Run Conformance Tests
Before calling your integration live, run the UCP conformance test suite against your endpoints. This catches issues with edge cases like out-of-stock checkout attempts, price changes between discovery and purchase, and shipping address validation failures.
npx @ucp/conformance-suite test --merchant https://your-store.myshopify.comThe suite runs approximately 40 test cases against your discovery and checkout endpoints. A passing run looks like:
UCP Conformance Suite v1.2.4
Merchant: your-store.myshopify.com
Running discovery tests... 28/28 passed
Running checkout tests... 11/12 passed
Running order management... 4/4 passed
RESULT: PASS (43/44)
1 warning: CHECKOUT_TIMEOUT exceeded threshold on high-latency test (1840ms, threshold 1500ms)
Conformance level: standard
Report saved to: ./ucp-conformance-report-2026-03-26.jsonWarnings are non-blocking but worth addressing. Checkout latency above 1.5 seconds will result in a degraded experience for agents that enforce timeouts.
If you see failures on the checkout flow, the most common cause is a Shopify app conflict. Apps that add custom checkout steps (loyalty programs, subscription management, upsell overlays) occasionally interfere with UCP's programmatic checkout flow. Test with apps disabled one at a time to isolate the issue.
Step 6: Monitor via Shopify Analytics
Once live, UCP traffic appears in Shopify Analytics under the Sales channels section as Agent Commerce. Key metrics to watch:
- Agent sessions: Incoming UCP discovery requests from agents
- Checkout initiations: Sessions that proceeded to checkout
- Completed orders: Fully confirmed UCP transactions
- Agent conversion rate: Checkout initiations divided by completed orders
Give it a week or two before drawing conclusions. Agent traffic patterns are different from organic web traffic: session counts are lower but conversion rates are structurally higher because agents only initiate checkout when the consumer has confirmed intent.
Optional: Identity Linking Setup
UCP's Identity Linking feature lets consumers connect their store account to their AI agent, so the agent can access saved addresses, order history, and loyalty points. This is optional but recommended for stores with active account programs.
To enable it, go to Settings > Checkout > Agent Commerce > Identity Linking and toggle it on. You will need to provide your Shopify store's OAuth client ID (found under Settings > Apps and sales channels > Develop apps) to complete the configuration. Shopify handles the token exchange; you do not need to write any OAuth flow code.
Common Issues and Fixes
Manifest returns 404: UCP not yet propagated. Wait 30 minutes. If on a custom domain, verify that your-domain.com/.well-known/ucp resolves (not just the myshopify.com subdomain). The .well-known path must be accessible at your primary storefront domain.
Conformance suite reports CHECKOUT_INVALID_PAYMENT: Your payment processor is not in the certified list or Shopify Payments is not the active payment method. Verify under Settings > Payments.
Google Merchant Center link pending for more than 24 hours: The manifest merchant_id may not match the domain registered in Merchant Center. Check that both domains are identical, including whether www is present or absent.
Agent sessions visible but no completed orders after two weeks: Check whether any checkout apps are blocking the UCP flow. Run the conformance suite again with --verbose for request/response logs. Also verify that catalog sync is not set to an empty collection.
Identity Linking not working: This feature requires Shopify Plus or Advanced. It is not available on Basic or standard Shopify plans.
Where to Go From Here
With UCP enabled, your store is discoverable and purchasable by any compliant AI agent. The ecosystem is growing quickly: UCPList tracks over 140 verified UCP implementations including agent integrations, SDKs, and developer tools relevant to merchants who want to go deeper.
For merchants who want to go beyond basic UCP and implement custom catalog filtering, wholesale price tiers for specific agents, or multi-location inventory routing through UCP, the UCP SDK documentation covers the Shopify-specific extensions. The UCPList blog will also have a follow-up post covering advanced UCP configuration for Shopify Plus merchants later this quarter.
The conformance test suite is the most reliable way to catch integration problems before they affect real customers. Run it every time you make significant changes to your checkout configuration or install new checkout apps.
Read next
Step-by-step instructions for enabling UCP on your Shopify store. From toggling the feature to verifying your endpoint.
How to add UCP checkout to a WooCommerce store in 2026. Plugin setup, manifest configuration, payment handler wiring, and going live.
Enterprise UCP adoption looks different from DTC. Platform-level rollouts, B2B procurement agents, and ERP integration are defining the pattern.