🛒 WooCommerce UCP Implementation

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 customer asks ChatGPT "find me a blue wool sweater under $50," the AI 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 are the new search engines: Google AI Mode, ChatGPT Shopping, and Microsoft Copilot are sending buying-intent traffic directly to UCP-enabled stores. Stores without UCP are invisible to these agents.
• 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: Dedicated UCP plugins (UCP Connect, UCP Hub) make setup possible without coding
• 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 UCP Connect Plugin

The UCP Connect plugin handles everything: it creates the UCP profile, implements the required API endpoints, and enables AI agent checkout capabilities.

1. Go to Plugins → Add New in your WordPress admin
2. Search for "UCP Connect" or "UCP WooCommerce"
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 = [
            'profile_version' => '1.0',
            'merchant' => [
                'name' => get_bloginfo('name'),
                'url' => home_url(),
                'description' => get_bloginfo('description'),
                'contact' => [
                    'email' => get_option('woocommerce_email_from_address')
                ]
            ],
            'capabilities' => ['browse', 'search'],
            'policies' => [
                'returns_url' => get_privacy_policy_url(),
                'shipping_url' => home_url('/shipping-policy/'),
                'privacy_url' => get_privacy_policy_url()
            ],
            'service_bindings' => [
                [
                    'type' => 'REST',
                    'base_url' => home_url('/wp-json/wc/v3')
                ]
            ]
        ];
        
        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

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

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