> ## Documentation Index
> Fetch the complete documentation index at: https://docs.animam.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress plugin

> Deploy an Animam agent on your WordPress site in 5 minutes

The official Animam plugin (PHP 7.4+, WordPress 6.0+) ships everything needed to deploy an agent on your site:

* **Public chat widget** — toggleable from `Settings → Animam`, injected on the front-end.
* **Auto-sync** — posts, pages and custom post types are pushed to the agent's knowledge base via idempotent `externalId` upsert. Publish → upsert; unpublish or delete → remove.
* **Bridges** — the agent drives the plugins you already use (WPForms, WooCommerce, MailPoet) instead of ingesting data into a parallel Animam table. See [Bridges](#bridges) below.
* **Admin assistant** — second chatbot in `wp-admin` with 16 admin tools (SEO audit, image alt bulk, schema, drafts, posts, terms, media, scheduling) plus a `wp_rest_call` escape hatch. Same brain as the public agent, scoped by your WordPress user capabilities.
* **Discoverability** — auto-publishes 6 well-known files (`llms.txt`, `llms-full.txt`, `agent.json`, `mcp.json`, `llmfeed.json`, `agent-skills/index.json`) on the WordPress origin, plus JSON-LD on every page.
* **Auto-update** — manifest at `https://api.animam.ai/wp/plugin-meta?slug=animam`, native update notifications in `wp-admin`.

Source: [github.com/animam-ai/animam.ai/tree/master/wordpress/animam](https://github.com/animam-ai/animam.ai/tree/master/wordpress/animam)

## Why bridges instead of an Animam-owned data store

The agent could capture leads in its own CPT or DB and post them back to your site via webhook — but that means **two parallel data stores**, **two automation layers**, and the tenant's existing Zapier/CRM/notification flow has to be re-wired around Animam.

Bridges keep the existing pipeline intact:

|                          | Without bridges (deprecated)      | With bridges (today) |
| ------------------------ | --------------------------------- | -------------------- |
| Where leads land         | `animam_submission` CPT           | WPForms entries      |
| Where orders land        | `animam_submission` CPT           | WooCommerce orders   |
| Where subscriptions land | `animam_submission` CPT           | MailPoet subscribers |
| Existing automations     | break — re-wire to Animam webhook | keep firing as-is    |
| Audit trail              | Animam-side only                  | both sides           |

The agent becomes an **additive layer**: visitor talks to the agent, agent calls the plugin, plugin persists like a human would have.

## Bridges

Three bridges ship today:

<CardGroup cols={3}>
  <Card title="WPForms" icon="square-pen" href="/wordpress/bridges/wpforms">
    Agent submits any of your WPForms forms on behalf of the visitor through the native pipeline.
  </Card>

  <Card title="WooCommerce" icon="cart-shopping" href="/wordpress/bridges/woocommerce">
    Agent searches products, adds to cart, drives the visitor to native checkout.
  </Card>

  <Card title="MailPoet" icon="envelope" href="/wordpress/bridges/mailpoet">
    Agent subscribes visitors to whitelisted lists, double opt-in preserved.
  </Card>
</CardGroup>

## Five-minute install

1. Download the latest plugin ZIP from `https://api.animam.ai/wp/plugin-download/<version>` (or the [GitHub source](https://github.com/animam-ai/animam.ai/tree/master/wordpress/animam)).
2. In `wp-admin`, go to **Plugins → Add New → Upload Plugin** and upload the ZIP.
3. Activate the plugin.
4. Go to **Settings → Animam**, paste your **tenant slug** and **API key** (from your Animam dashboard).
5. Click **Test connection**, then **Resync all** to push existing content.
6. Toggle the widget on. Done.

## Plan requirements

| Capability                                     | Plan                            |
| ---------------------------------------------- | ------------------------------- |
| Public widget + auto-sync                      | Visitors · Bundle               |
| Bridges (WPForms, WooCommerce, MailPoet)       | Bundle (`mcp_tools` capability) |
| Admin assistant                                | Admin · Bundle                  |
| MCP server (external agents calling your site) | Admin · Bundle                  |

<Info>
  The Animam Free plan is reserved for API exploration on animam.ai. The WordPress widget assumes a real audience and is gated on the Visitors plan (€19/month) or higher.
</Info>

See the [WordPress pricing page](https://animam.ai/wordpress#plans) for the full plan matrix.

<Note>
  **WordPress plans require an active plugin.** The `wp_frontend`, `wp_admin` and `wp_bundle` plans are reserved for sites running the official Animam plugin. The plugin pings `/tenants/:slug/plan` hourly — if no ping is observed for 60 days, the public chat is suspended until the plugin is reactivated. New tenants benefit from a 30-day onboarding grace period. To use Animam on a non-WordPress site, see [animam.ai pricing](https://animam.ai/pricing).
</Note>