UCP Checker & Validator /.well-known/ucp

How to Add UCP to a WordPress Site With WooCommerce

Unlike Shopify, there is no official WooCommerce or Automattic UCP integration. What exists instead is a handful of independent, third-party plugins on the WordPress.org directory. Here is exactly what each one does, verified directly against its live listing, not secondhand claims.

Read this before choosing a plugin

As of this writing, every WooCommerce UCP plugin we checked on WordPress.org has fewer than a dozen active installations, and most have zero or one review. That does not mean they do not work, they are real, published plugins, but none has an established track record yet. Check the live install count and reviews on each plugin's WordPress.org page yourself before committing, since those numbers change.

Your two real options

For a WooCommerce store, there are two genuinely different paths to a working UCP manifest:

  1. Install a third-party plugin that generates and serves the manifest for you.
  2. Build the manifest yourself, since it is just a JSON file served at a specific path, which a developer can create directly without any plugin.

The plugins that actually exist

These are the three UCP-related plugins we found published on the official WordPress.org plugin directory, with the current numbers pulled directly from their listings.

Universal Commerce Protocol (UCP) for WooCommerce

10+ active installs 0 reviews v1.0.4

Runs locallyServes /.well-known/ucp directly from your own WordPress install. The only outbound call is fetching a static schema file from ucp.dev, no personal, store, or customer data leaves your site for that.

Supports REST, MCP, and an embedded protocol binding, OAuth 2.0 identity linking, and includes a built-in test simulator. By developer "siteupgradepro."

UCP Adapter For WooCommerce

10+ active installs 1 review, 5 stars v1.0.3

Runs locallyProvides session, update, and checkout-completion REST endpoints for UCP-style integrations. Explicitly states it does not send data to external services. By developer "Dhiraj Patra."

Worth noting: based on its own listing, this plugin focuses on the session/checkout API layer rather than explicitly generating the /.well-known/ucp discovery file itself, so confirm it covers what you actually need before relying on it alone.

UCPhub for WooCommerce

Fewer than 10 active installs 2 reviews, 5 stars v2.1.0

Sends data externallyConnects to UCPhub's own API (api.ucphub.ai) and requires creating an account there. Per its own disclosure, it sends your store URL and WooCommerce REST API credentials (consumer key and secret) to UCPhub's servers during setup.

Has the most active development history of the three, based on its changelog (embedded checkout, HPOS compatibility), and is the only one built by a company with its own product site rather than an individual developer. That also means your store becomes dependent on a third party's service staying available and trustworthy with your API credentials, a real tradeoff to weigh, not a reason to rule it out by itself.

Comparing them at a glance

PluginData leaves your site?Active installsReviews
UCP for WooCommerce ("UCP Ready")No (schema fetch only)10+0
UCP Adapter For WooCommerceNo10+1
UCPhub for WooCommerceYes, to UCPhub's APIFewer than 102

Using a plugin: the general steps

  1. Confirm your WooCommerce version

    Each plugin lists minimum WordPress, WooCommerce, and PHP versions on its WordPress.org page. Check compatibility before installing.

  2. Install from Plugins > Add New

    Search for the plugin by name in your WordPress admin, or upload the ZIP manually if installing from outside the directory.

  3. Complete any required setup

    Self-hosted plugins typically generate an API key automatically on activation. Externally-connected plugins, like UCPhub, require creating an account on their service and entering credentials from their dashboard.

  4. Verify the manifest is actually being served

    Visit https://your-site.com/.well-known/ucp directly, or run it through our checker, to confirm it returns a valid, correctly structured document.

Building the manifest yourself

A UCP manifest is a plain JSON document, so a developer can create one directly without installing a plugin at all. At minimum, the current specification requires:

  • ucp.services, keyed by service name, with a version and transport on each descriptor
  • ucp.payment_handlers, listing which payment methods you accept
  • A root level signing_keys array (an empty array is valid if you are not signing payloads yet)

Serve the resulting JSON file at /.well-known/ucp on your domain. This is the same structure our UCP guide covers in more depth, and the same structure our validator checks against.

Check what you end up with

Whether you install a plugin or build it by hand, verify the actual result before you consider it done.

Frequently asked questions