·12 min read·UCPReady Team

UCP Compliance Checklist: Is Your E-Commerce Store Ready?

A step-by-step UCP compliance checklist for Shopify and WooCommerce merchants. Validate your /.well-known/ucp manifest, fix common errors, and verify with curl commands.

ucpcompliancechecklistshopifywoocommerce

When the Universal Commerce Protocol launched in January 2026, it did not make headlines in the mainstream business press. But inside the e-commerce community, the implications landed fast. Google, Shopify, Walmart, and more than twenty other partners had built a shared standard for AI shopping agents — a machine-readable manifest that lets any AI agent natively read your store's catalog, understand what you sell, and facilitate purchases without scraping or guesswork.

The implication for merchants is direct: if your store is not UCP-compliant, AI agents will skip you. Not maliciously — they will simply find it harder to extract reliable product data from your store than from a UCP-enabled competitor, and they will route shopping queries accordingly.

This checklist walks you through a complete UCP audit. You will learn what the manifest must contain, how to check if yours is valid, what errors to look for, and how to get compliant on both Shopify and WooCommerce.

#What UCP Compliance Actually Means

UCP compliance has one core requirement: you must serve a valid JSON manifest at the well-known URL path /.well-known/ucp on your domain. That means if your store lives at https://mystore.com, the manifest must be accessible at https://mystore.com/.well-known/ucp.

But just serving something at that path is not enough. Compliance means the manifest is:

  • Reachable — returns an HTTP 200 status code, not a 404 or redirect
  • Valid JSON — no syntax errors, trailing commas, or encoding issues
  • Properly typed — served with Content-Type: application/json
  • Complete — contains the required fields that AI agents need to interact with your store
  • Accurate — catalog URLs resolve to real, current product data

The manifest is the entry point for every AI agent that wants to interact with your store. Getting it right is foundational. Everything else — schema markup, robots.txt configuration, AI visibility — builds on top of it.

For deeper background on what UCP is and why it exists, see What Is UCP? The Universal Commerce Protocol Explained for Shopify and WooCommerce Merchants.

#Step-by-Step UCP Audit

Work through these five steps in order. Each one builds on the previous.

Check if your manifest exists

The fastest way to verify your manifest is live is with a curl command. Open a terminal and run:

BASH
curl -s https://yourstore.com/.well-known/ucp | jq .

Replace yourstore.com with your actual domain. If you do not have jq installed, run the command without the | jq . portion — you will just see raw JSON output instead of pretty-printed output.

A healthy response looks like a JSON object starting with {. If you see a 404 page, HTML content, or an error message, your manifest is either missing or misconfigured. Note the HTTP status code too — run curl -I https://yourstore.com/.well-known/ucp to see just the headers. You want HTTP/2 200 with content-type: application/json.

If you get a redirect (301 or 302), check where it leads. Some server configurations redirect /.well-known/ paths to the homepage, which breaks AI agent discovery entirely.

Validate the JSON structure

Once you have confirmed the manifest exists, validate its structure. Paste the JSON into jsonlint.com or run it through a JSON schema validator.

A valid UCP manifest follows this structure:

JSON
{
  "version": "1.0",
  "merchant": {
    "name": "Your Store Name",
    "url": "https://yourstore.com",
    "supportedLocales": ["en-US"]
  },
  "capabilities": {
    "productDiscovery": true,
    "checkout": true,
    "orderManagement": false
  },
  "catalog": {
    "url": "https://yourstore.com/products.json",
    "format": "json"
  }
}

Pay particular attention to:

  • No trailing commas{"key": "value",} is invalid JSON even though many code editors tolerate it
  • Double quotes only — JSON does not accept single quotes around keys or values
  • Correct nestingmerchant, capabilities, and catalog are all objects, not strings
  • No comments — JSON does not support // or /* */ comments

A single malformed character can cause the entire manifest to be unreadable. If you are generating the manifest dynamically, test it in staging after every deploy.

Check required fields are populated

A syntactically valid manifest can still fail compliance if required fields are missing or empty. Verify that your manifest includes all three of these:

merchant.name — Your store's display name. This is what AI agents use to identify your business when forming recommendations. It should match your actual brand name, not a generic placeholder like "My Store" or "Company Name."

capabilities — At minimum, productDiscovery: true. This signals that AI agents are welcome to browse and index your catalog. Without this field, some agents will treat your store as not participating in AI commerce even if the manifest is technically present.

catalog.url — The URL of a machine-readable product feed. This is what AI agents actually fetch to retrieve your product data. The URL must be publicly accessible (no authentication required for the base catalog), resolve to current inventory, and return structured product data.

If your catalog URL returns stale data or requires an API key, AI agents either cannot read it or will be working with outdated product information — both of which undermine your AI visibility.

Test with the UCPReady scanner

Manual checks are useful but incomplete. The UCPReady.ai scanner automates the full compliance check: it fetches your manifest, validates the JSON, checks required fields, attempts to retrieve your catalog URL, verifies crawler access, and scores your store across all four AI readiness pillars.

Run a scan at UCPReady.ai — no account required. The scanner returns a scored report with specific findings, not just a pass/fail result. If your manifest has an issue, the report will tell you exactly which field is missing or which URL is returning an error.

Beyond UCP, the scanner also checks your robots.txt configuration to confirm that AI crawlers like GPTBot, ClaudeBot, and PerplexityBot are allowed to access your store. A valid UCP manifest on a domain that blocks AI crawlers is a contradiction — the manifest invites agents in while robots.txt turns them away. Both need to be correct.

You can also use the AI Crawler Checker to run a targeted check on your crawler access configuration separately from the full scan.

Set up monitoring

UCP compliance is not a one-time task. Your manifest can break after a platform update, a server configuration change, a domain migration, or a botched deployment. If it breaks silently, you lose AI agent discoverability without knowing why your AI traffic dropped.

Set up a simple uptime monitor — most uptime monitoring services (Better Uptime, UptimeRobot, Pingdom) let you monitor specific URLs. Point a monitor at https://yourstore.com/.well-known/ucp and configure it to alert you if the URL returns anything other than an HTTP 200.

Additionally, re-run a full UCPReady scan every four to six weeks, and always run one after major platform updates or theme changes. On Shopify, platform updates occasionally reset settings in Sales Channels. On WooCommerce, plugin updates can overwrite custom endpoint configurations.

The merchants who maintain compliance consistently — not just at initial setup — are the ones who stay visible as AI shopping agents continue to expand.

#Common Errors and How to Fix Them

These are the compliance failures that show up most frequently when scanning e-commerce stores. Each one prevents AI agents from reading your manifest correctly.

#Platform-Specific Instructions

#Shopify

Shopify has built-in UCP support through its Agentic Storefronts feature. If you are on Shopify, you do not need to write JSON manually — Shopify generates and serves the manifest for you.

To enable it:

  1. In your Shopify admin, go to Settings > Sales Channels
  2. Find Agentic Storefronts and toggle it on
  3. Review the configuration — Shopify will auto-populate your store name, catalog URL (linked to your /products.json endpoint), and default capabilities
  4. Save and verify by visiting https://your-store.myshopify.com/.well-known/ucp

The main thing to check after enabling: confirm that your product catalog data is complete. Shopify generates the manifest from your existing product data — if your products have thin descriptions, missing images, or blank SKU fields, those gaps will be reflected in the catalog that AI agents receive.

#WooCommerce

WooCommerce does not yet have native UCP support, so you have two options: install a UCP plugin or implement the manifest manually.

Plugin route: Search the WordPress plugin directory for UCP or AI Commerce plugins. Several have launched since the protocol was announced. Look for one that generates the manifest dynamically from WooCommerce product data and keeps it updated as inventory changes.

Manual route: If you are comfortable with PHP, you can register a custom endpoint in your theme's functions.php or in a custom plugin:

PHP
add_action('init', function() {
  add_rewrite_rule(
    '^\.well-known/ucp$',
    'index.php?ucp_manifest=1',
    'top'
  );
});

add_filter('query_vars', function($vars) {
  $vars[] = 'ucp_manifest';
  return $vars;
});

add_action('template_redirect', function() {
  if (get_query_var('ucp_manifest')) {
    $manifest = [
      'version' => '1.0',
      'merchant' => [
        'name' => get_bloginfo('name'),
        'url' => home_url(),
        'supportedLocales' => ['en-US'],
      ],
      'capabilities' => [
        'productDiscovery' => true,
        'checkout' => true,
        'orderManagement' => false,
      ],
      'catalog' => [
        'url' => home_url('/wp-json/wc/v3/products'),
        'format' => 'json',
      ],
    ];
    header('Content-Type: application/json');
    echo json_encode($manifest);
    exit;
  }
});

After adding this code, flush your WordPress rewrite rules by visiting Settings > Permalinks and clicking Save. Then verify the manifest is live with the curl command from Step 1.

Note: if you use the WooCommerce REST API as your catalog URL, you will need a read-only API key. Consider whether to use that approach or a public product feed plugin that does not require authentication.

#Example UCP Manifest

Here is a complete, valid UCP manifest that satisfies all required fields:

JSON
{
  "version": "1.0",
  "merchant": {
    "name": "Example Store",
    "url": "https://example-store.com",
    "supportedLocales": ["en-US"]
  },
  "capabilities": {
    "productDiscovery": true,
    "checkout": true,
    "orderManagement": false
  },
  "catalog": {
    "url": "https://example-store.com/products.json",
    "format": "json"
  }
}

This is the minimum viable manifest. For a more complete implementation, you can add supportedCurrencies, a policies object (returns, shipping), and additional capabilities as your platform supports them. But this structure passes every compliance check and gives AI agents what they need to discover and recommend your products.

#Where UCP Fits in the Bigger Picture

UCP compliance is one of four pillars of AI shopping readiness — alongside crawler access, structured data quality, and AI visibility. A store can be UCP-compliant but still invisible to AI agents if its robots.txt blocks crawlers, its product schema is incomplete, or its product descriptions are too thin for AI agents to synthesize meaningful recommendations.

For the full picture of how these pillars work together and what a complete AI readiness audit looks like, see What Is Agentic SEO? The Complete Guide for E-Commerce in 2026.

The stores that are winning AI shopping traffic right now are not just UCP-compliant — they are compliant across all four pillars. But UCP is the right place to start, because it is the clearest signal to AI agents that your store is explicitly built for AI commerce.

Check your store’s AI readiness

Free scan — see how AI shopping agents perceive your store in under 60 seconds.

Scan Your Store Free