AgenticCart
Docs Setup WooCommerce integration

WooCommerce integration

Connect a WooCommerce store to an AI shopping assistant: install the AgenticCart plugin, pair your license key, and sync your catalog ready for agents.

The AgenticCart WooCommerce AI shopping assistant integration pairs your WordPress + WooCommerce store with AgenticCart so a hosted AI sales agent can recommend products from your live catalog. The official plugin handles pairing, catalog sync, and domain verification in one flow, so you do not need to write code or maintain a separate product feed.

Connect WooCommerce to an AI shopping assistant

This guide walks through installing the AgenticCart WooCommerce plugin, pairing the store with your account, running your first sync, and handing the catalog off to a collection that powers an AI sales agent. If you have not yet decided between the plugin and a product feed, start on the connect your store overview.

Requirements

  • An active WooCommerce store on a self-hosted or managed WordPress environment.
  • WordPress admin access with permission to install and activate plugins.
  • An AgenticCart account with an active plan or trial, and your AgenticCart license key.
  • Outbound HTTPS access from your WordPress host to AgenticCart (most hosts allow this by default).

Install the AgenticCart WooCommerce plugin

  1. 1

    Download the plugin package

    Sign in to your AgenticCart dashboard and download the WooCommerce plugin from the integrations area. The dashboard always serves the current version for your account.
  2. 2

    Upload it in WordPress

    In WordPress, go to Plugins → Add New → Upload Plugin, choose the AgenticCart zip, and click Install. Activate the plugin once the upload finishes.
  3. 3

    Open the AgenticCart settings screen

    A new AgenticCart entry appears in the WordPress admin sidebar after activation. Open it to find the license-key field and the sync controls.

Pair your store with AgenticCart

  1. 1

    Copy your license key

    In the AgenticCart dashboard, open your integration settings and copy the license key. This key identifies your store to AgenticCart during sync.
  2. 2

    Paste the key into WordPress

    Back in the AgenticCart plugin settings, paste the key and save. The plugin attempts to reach AgenticCart and confirms the pairing.
  3. 3

    Confirm the connected state

    The plugin displays a connected status when pairing succeeds. The matching WooCommerce store also appears as verified in your AgenticCart dashboard.

WARNING

Treat your license key like a password. Do not publish it in screenshots, git repositories, support forum posts, or public chat channels. Rotate it from the dashboard if it is ever exposed.

Run your first catalog sync

After pairing, trigger a catalog sync from the plugin. The sync sends your WooCommerce catalog to AgenticCart so products become available for collections and agents. Progress is visible in both WordPress and your AgenticCart dashboard, and large catalogs may take several minutes on the first run.

TIP

Syncing imports the catalog. Recommendations only start once you add the synced products to a collection and assign that collection to an AI sales agent. See create a collection.

What the plugin sends (and what it does not)

The plugin is scoped to product catalog data the AI sales agent needs to answer shopper questions:

  • Product titles, descriptions, and slugs.
  • Canonical product URLs and images.
  • Regular prices, sale prices, currency, and stock status.
  • Categories, tags, brand, and product attributes.
  • Variable products and their variants (size, colour, material, configuration).

AgenticCart does not replace WooCommerce checkout. Shoppers still complete purchases on your WordPress store, using the same payment gateways, tax rules, shipping methods, coupon logic, and order management you have today. The plugin reads product data; it does not take over billing, customers, orders, or fulfillment.

When to sync again

  • You added or removed products, categories, or variants.
  • You changed prices, sale prices, or stock status.
  • You rewrote product titles, descriptions, or attributes.
  • You swapped images or rotated seasonal collections.

See the catalog sync overview for the bigger picture of how AgenticCart keeps AI recommendations aligned with your store.

Troubleshooting the WooCommerce connection

  • Plugin will not connect — re-check the license key and confirm your WordPress host can reach agenticcart.ai over HTTPS. Some managed hosts block outbound requests by default.
  • Sync does not start — check the plugin status screen, your AgenticCart plan status, and your WordPress server error log.
  • Products are missing after sync — confirm they are published (not draft), in stock, and visible in the WooCommerce catalog visibility settings.
  • AI agent does not recommend synced products — open the agent, inspect its assigned collection, and add the missing products there.
  • Domain still shows as unverified — see AI agent domain verification to add the WordPress site as a verified domain.

Frequently asked questions

Does the AgenticCart WooCommerce plugin affect my checkout?
No. The plugin only reads product catalog data. WooCommerce still owns your cart, checkout, payments, orders, tax, and shipping. Shoppers who click a product card in the AI sales agent land on your normal WooCommerce product page.
Will installing the plugin slow down my WordPress site?
No. The plugin runs server-side sync work on your schedule and does not add any scripts to the shopper-facing storefront. The AI agent itself is hosted on an AgenticCart domain, not injected into your WordPress theme, so page speed is unaffected by default.
Can I use AgenticCart on a multisite WooCommerce install?
Each WordPress + WooCommerce site is treated as its own catalog. Activate the plugin on each site you want to connect and pair each one with the matching AgenticCart store. Plan limits decide how many stores a single account can run.
What happens if I deactivate the plugin?
Deactivating the plugin pauses catalog sync. Existing product data stays in AgenticCart, and any live AI sales agent keeps running with the most recent catalog snapshot until you reactivate and sync again or switch to a feed.
Does the plugin sync variable products and variants?
Yes. Variable products are imported with their variants so the AI shopping assistant can recommend the correct size, colour, or configuration. Make sure each variant has accurate stock and price data in WooCommerce for the best answers.

Next steps

Create a collection

Choose which WooCommerce products the AI agent can recommend.

Create an AI sales agent

Turn the collection into a branded shopping assistant.

Verify your domain

Approve ownership of the domain your hosted chat will run on.