🛒 WooCommerce UCP Implementation

Why Add UCP to WooCommerce?

WooCommerce powers over 5 million online stores. Adding UCP (Universal Commerce Protocol) support makes your store discoverable by AI agents, enabling automatic product discovery and purchases through ChatGPT, Google AI Mode, and other AI assistants.

• WordPress Flexibility: Full control over implementation via themes or plugins
• REST API Ready: WooCommerce's REST API makes UCP integration natural
• Schema.org Support: Many WooCommerce themes already include structured data
• Plugin Ecosystem: Dedicated UCP plugins available

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 Issues & Solutions

🤖 Test with AI Agents

Resources

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