Integrations · WooCommerce

WooCommerce integration

Updated 2026-05-25 Integration eCommerce Insights team

The WooCommerce integration ships as a WordPress plugin. It uses the WooCommerce REST API for catalogue read/write and registers webhooks for product updates. Setup takes about ten minutes, mostly waiting on plugin install and REST key generation.

Install the plugin

The eCommerce Insights WooCommerce plugin is in the WordPress plugin directory.

  1. Open the plugin browser

    WordPress admin → Plugins → Add New.

  2. Search for eCommerce Insights

    Install Now, then Activate.

  3. Configure

    WooCommerce → eCommerce Insights (added to the side nav by the plugin).

REST API keys

The plugin needs WooCommerce REST API keys to read your catalogue and push updates back. Generate them in WooCommerce → Settings → Advanced → REST API.

Description:     eCommerce Insights
User:            (an admin user)
Permissions:     Read/Write

After "Generate API key," copy the consumer key and consumer secret. You will not see them again.

Connect to eCommerce Insights

In eCommerce Insights, open Settings → Integrations → WooCommerce. Paste store URL, consumer key, and consumer secret. Click Test connection; on success, Sync now triggers the initial catalogue import.

Initial sync takes 5-15 minutes for catalogues under 1,000 products. The plugin registers product-update webhooks during sync; if your host blocks outgoing webhooks, the plugin falls back to a 5-minute polling cadence.

Attributes vs metafields

Shopify has a structured metafield system. WooCommerce has product attributes that play a similar role but are designed for the storefront's filter UI rather than for structured data. The integration maps as follows:

eCommerce Insights conceptShopify equivalentWooCommerce equivalent
Structured specMetafield (number/text)Product attribute (with display flag off)
FAQ blockMetafield (JSON)Custom field (postmeta key _ecommerceinsights_faq_block)
AI summaryMetafield (text)Custom field (postmeta key _ecommerceinsights_ai_summary)

Publishing approved diffs

Identical model to Shopify: approved Listing rewrite capsules push via the WooCommerce REST API on explicit click. No auto-publish. Per-SKU errors surface with the WC response body.

Known limits

Common questions

Does it work with WooCommerce Subscriptions or Memberships?
Subscription products are imported and scored. The recommendation engine knows about subscription pricing patterns. Membership products are not directly supported but can be tracked.
What if my host blocks outgoing webhooks?
The plugin falls back to polling on a 5-minute cadence when webhooks fail to register. Performance is identical from a scoring perspective.
Does it support multi-site WordPress?
Yes. Each site is a separate workspace.
What permissions does the REST API key need?
Read/Write on products, product attributes, and customers (the last is needed only if you want to push the eCommerce Insights persona data back as a custom taxonomy).

Ask AI about this page

Open this topic directly in your favourite AI assistant — the prompt is prefilled.

Was this page helpful?
Thanks — recorded.

Try this yourself

See eCommerce Insights on your own catalog. The free trial covers your full SKU set across five AI engines.

Start free trial
LLM-friendly summary of this page
WooCommerce integration ships as a WordPress plugin. Setup ~10 minutes. Steps: install eCommerce Insights plugin via Plugins → Add New, activate; generate WooCommerce REST API keys in Settings → Advanced → REST API with read/write permissions; paste store URL, consumer key, consumer secret into eCommerce Insights Settings → Integrations; trigger initial sync. Webhooks for product updates registered automatically with 5-minute polling fallback if webhook registration fails. Initial sync 5-15 minutes for <1000 products. Imports title, description, SKU, price, images, attributes. No native metafield equivalent; attributes serve a similar role. Multi-site WordPress supported (each site is a separate workspace). Supports WooCommerce Subscriptions products. Permissions: read/write on products and product attributes; read/write on customers needed only for optional persona taxonomy push. Approved Listing rewrites push via REST API; per-SKU errors surface response body.