WooCommerce UCP Setup Guide: Make Your Store AI-Ready in 10 Minutes

What is UCP?

UCP (Universal Commerce Protocol) is the open standard created by Google and Shopify that lets AI shopping agents discover, browse, and buy from your store. It works by serving a JSON manifest at /.well-known/ucp on your domain, telling agents what your store sells, how to search products, and how to complete checkout.

When a shopper asks Google AI Mode "find me a blue wool sweater under $50," the Gemini agent reads your UCP profile to understand your catalog, browses your products via API, and can complete the purchase — all without the customer visiting your website directly. Learn more about how UCP works.

Why Add UCP to WooCommerce?

WooCommerce powers over 5 million online stores, but unlike Shopify (which added native UCP support), WooCommerce stores need manual setup to become AI-ready. Here is why it is worth the effort:

• AI agents convert at 5-10x higher rates: Agent-referred sessions convert at 15-30% vs. 2-3% for traditional search traffic (Presta, 2026). Google AI Mode and Gemini route buying-intent queries directly to UCP-enabled stores. Stores without UCP are invisible to these agents. (Note: ChatGPT Shopping uses ACP, a separate protocol.)
• WordPress flexibility: Full control over implementation via themes, plugins, or custom code - no platform lock-in
• REST API ready: WooCommerce's REST API maps naturally to UCP's endpoint requirements for product search, cart, and checkout
• Schema.org head start: If you use Yoast or Rank Math, your products likely already have the structured data that UCP builds on
• Plugin ecosystem: UCP can be added without writing code - the free UCPtools plugin for discovery, and several third-party plugins for a full agent checkout
• Both UCP and ACP coverage: WooCommerce can serve both UCP (Google/Shopify agents) and ACP (ChatGPT Shopping via Stripe) from the same store

Implementation Methods

Choose the method that best fits your needs:

Method 1: UCP Proxy by Shopify (Recommended)

UCP Proxy is an open-source proxy by Shopify that enables full UCP checkout capabilities for WooCommerce stores. Your store remains the system-of-truth; the proxy translates UCP requests to WooCommerce API calls.

• WooCommerce 6.9+ (for Store API support)
• WooCommerce REST API keys (Read/Write)
• Optional: Stripe plugin for Google Pay
• Go 1.21+ (for running the proxy)

# Clone the repository
git clone https://github.com/Shopify/ucp-proxy
cd ucp-proxy

# Create config file
cp config.example.json config.local.json

Edit config.local.json:

{
  "port": "8080",
  "adapter_type": "woocommerce",
  "merchant_id": "my-store",
  "merchant": {
    "store_url": "https://yourstore.com",
    "api_key": "ck_your_consumer_key",
    "api_secret": "cs_your_consumer_secret",
    "policy_links": {
      "privacy_policy": "https://yourstore.com/privacy",
      "terms_of_service": "https://yourstore.com/terms"
    }
  }
}

# Start the proxy
CONFIG_FILE=config.local.json go run ./cmd/proxy

# Test discovery endpoint
curl http://localhost:8080/.well-known/ucp

Deploy to GCP Cloud Run, AWS, or any container hosting:

# GCP Cloud Run example
gcloud run deploy ucp-proxy \
  --source . \
  --region us-central1 \
  --allow-unauthenticated

Method 2: Using a WooCommerce UCP Plugin

Plugins add UCP support without requiring server infrastructure. For discovery - being found by AI agents at all - use the free UCPtools plugin. For a full agent-driven checkout, several third-party plugins implement the complete lifecycle; the steps below apply to most of them.

1. Go to Plugins → Add New in your WordPress admin
2. Search for a WooCommerce UCP plugin, or upload the UCPtools plugin ZIP via Upload Plugin
3. Click Install Now, then Activate

1. Go to WooCommerce → Settings → UCP
2. Enter your store details (most will be auto-filled from WooCommerce)
3. Review capabilities to expose (browse, search, checkout)
4. Click Save Changes

Visit https://yourstore.com/.well-known/ucp to see your generated UCP profile.

Method 3: Manual Implementation (Developers Only)

For full control, implement UCP manually using WordPress functions. This method is for developers who need custom UCP implementations.

Add this code to your theme's functions.php or a custom plugin:

// Add rewrite rule for /.well-known/ucp
function ucp_add_rewrite_rules() {
    add_rewrite_rule(
        '^\.well-known/ucp/?$',
        'index.php?ucp_profile=1',
        'top'
    );
}
add_action('init', 'ucp_add_rewrite_rules');

// Register query var
function ucp_query_vars($vars) {
    $vars[] = 'ucp_profile';
    return $vars;
}
add_filter('query_vars', 'ucp_query_vars');

// Handle UCP profile request
function ucp_template_redirect() {
    if (get_query_var('ucp_profile')) {
        header('Content-Type: application/json');
        header('Access-Control-Allow-Origin: *');

        $profile = [
            'ucp' => [
                'version' => '2026-01-11',
                'services' => [
                    'shopping' => [
                        'version' => '2026-01-11',
                        'spec' => 'https://ucp.dev/specification/',
                        'rest' => [
                            'endpoint' => home_url('/wp-json/wc/v3'),
                            'schema' => home_url('/wp-json/wc/v3/openapi.json'),
                        ],
                    ],
                ],
                'capabilities' => [
                    [
                        'name' => 'dev.ucp.shopping.catalog.search',
                        'version' => '2026-01-11',
                        'spec' => 'https://ucp.dev/draft/specification/catalog/',
                        'schema' => 'https://ucp.dev/schemas/shopping/catalog_search.json',
                    ],
                    [
                        'name' => 'dev.ucp.common.identity_linking',
                        'version' => '2026-01-11',
                        'spec' => 'https://ucp.dev/latest/specification/identity-linking/',
                        'schema' => 'https://ucp.dev/schemas/common/identity_linking.json',
                    ],
                ],
            ],
            'signing_keys' => [
                // Generate keys with: openssl ecparam -genkey -name prime256v1
                // Then export the public JWK. See ucptools.dev for key generation tool.
            ],
            'payment' => [
                'handlers' => [
                    [
                        'id' => 'stripe',
                        'name' => 'Stripe',
                        'version' => '2026-01-11',
                        'spec' => 'https://ucp.dev/handlers/stripe/',
                    ],
                ],
            ],
        ];

        echo json_encode($profile, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
        exit;
    }
}
add_action('template_redirect', 'ucp_template_redirect');

After adding the code, flush rewrite rules:

1. Go to Settings → Permalinks
2. Click Save Changes (no changes needed, just save)

Schema.org Markup

For maximum AI compatibility, ensure your products have proper Schema.org markup. Many WooCommerce themes include this by default.

Recommended Plugins

• Yoast SEO: Includes WooCommerce schema support
• Rank Math: Advanced schema options for products
• Schema Pro: Dedicated schema plugin

Verify your schema with:

• Google Rich Results Test
• Schema.org Validator

Validate Your Implementation

A WooCommerce UCP profile that looks correct can still fail for AI agents. There are four validation levels - most free validators only check Level 1 (JSON structure). Levels 2-4 catch the issues that actually block agent checkout:

Common WooCommerce UCP Issues and Solutions

After Setup: What to Expect

Once your WooCommerce UCP profile is live and validated:

1. AI agent discovery (1-7 days): Google and other crawlers will discover your /.well-known/ucp endpoint. You can speed this up by submitting your URL in Google Search Console.
2. Agent interactions begin: You will start seeing AI agent traffic in your server logs. Look for user agents containing "GPTBot", "Google-Extended", "Amazonbot", or "PerplexityBot".
3. Monitor with analytics: Track AI agent visits with UCPtools AI Agent Analytics to see which agents discover your products and how they interact with your store.
4. Keep your profile current: Update your UCP profile when you change store policies, add capabilities, or update product categories. Stale profiles reduce AI agent trust.

Test with AI Agents

Before waiting for real agent traffic, simulate how a Google AI Mode or Copilot shopping agent will interact with your WooCommerce store. The simulator runs the full UCP discovery flow: reads your /.well-known/ucp profile, negotiates capabilities, creates a test cart, and attempts a checkout session. It catches backend issues that structural validators miss - for example, a profile that passes all four validation levels but whose cart endpoint returns a 500 error when the agent actually calls it.

Frequently Asked Questions

Resources

• UCP Proxy by Shopify (GitHub)
• Official UCP Specification
• WooCommerce REST API Docs
• WordPress Rewrite API
• What is UCP? Complete Guide
• Check Your ACP (ChatGPT Shopping) Readiness
• UCP vs Schema.org Comparison
• Compare UCP Validation Tools
• Security Scan Your UCP Setup
• All Platform Guides
• Browse UCP-Enabled Stores