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

# WordPress

> Add Tiny Talk agents to your WordPress site with the official plugin.

The [Tiny Talk WordPress plugin](https://wordpress.org/plugins/tiny-talk/) gives you full control over which agents appear on which pages — without touching code.

## Installation

1. In your WordPress admin, go to **Plugins → Add New**
2. Search for **Tiny Talk**
3. Click **Install Now**, then **Activate**

Or download the plugin from [wordpress.org/plugins/tiny-talk](https://wordpress.org/plugins/tiny-talk/) and upload the ZIP via **Plugins → Add New → Upload Plugin**.

## Adding agents

Go to **Settings → Tiny Talk** and add your agents. You'll need the **Agent ID** for each agent, found in the Tiny Talk dashboard under **Agent Settings → General**.

You can add multiple agents and control which one appears on each page using rules.

## Default agent

Set a **default agent** that appears on all pages where no specific rule or page override applies. This is your fallback — if no other match is found, this agent loads.

## Display rules

Rules let you show different agents on different parts of your site. Rules are evaluated **top to bottom** — the first matching rule wins.

| Condition type    | Example                              | Description                                                        |
| ----------------- | ------------------------------------ | ------------------------------------------------------------------ |
| **Post type**     | `post`, `page`, `product`            | Match any post type, including custom post types                   |
| **Taxonomy**      | `category:news`, `product_cat:shoes` | Match a specific taxonomy term (format: `taxonomy_name:term_slug`) |
| **URL pattern**   | `/blog/*`, `/docs/**`                | Wildcard matching (`*` single segment, `**` multi-segment)         |
| **Page template** | `template-landing.php`               | Match a specific page template                                     |
| **User role**     | `subscriber`, `customer`             | Match logged-in users by role                                      |
| **Page ID**       | `42`, `42,56,78`                     | Match specific pages by ID (comma-separated for multiple)          |

Rules can be reordered by dragging and dropping. The order matters — place more specific rules above general ones.

## Per-page overrides

On any post or page, you'll find a **Tiny Talk Agent** meta box in the editor. Use it to:

* **Select a specific agent** for that page, overriding any rules
* **Disable the agent** entirely on that page by selecting "None"

Per-page overrides take the highest priority — they always win over rules and the default agent.

## Agent resolution priority

When a page loads, the plugin determines which agent to show in this order:

1. **Page override** — if set in the post/page editor, use that (or disable if set to "None")
2. **Rules** — evaluate top to bottom, first match wins
3. **Default agent** — fallback if nothing else matches

## Shortcode

Use the `[tinytalk]` shortcode to embed an agent inline on any page:

```
[tinytalk agent_id="YOUR_AGENT_ID"]
```

You can also reference an agent by the name you gave it in **Settings → Tiny Talk**:

```
[tinytalk agent="My Sales Agent"]
```

If you omit both attributes, the shortcode uses the agent resolved by your rules and default settings.

### Shortcode attributes

| Attribute  | Description                                                                   |
| ---------- | ----------------------------------------------------------------------------- |
| `agent_id` | Agent UUID — takes precedence over `agent`                                    |
| `agent`    | Agent name as configured in the plugin settings                               |
| `type`     | `iframe` (default) for inline embed, or `widget` for the floating chat widget |
| `width`    | Iframe width (default: `100%`)                                                |
| `height`   | Iframe height in pixels (default: `660`)                                      |
| `styled`   | `yes` (default) adds a border and shadow to the iframe, `no` removes them     |

This renders the agent as an embedded iframe within your content, rather than as a floating widget.

## Manual embed (without the plugin)

If you prefer not to use the plugin, you can add the script tag manually:

1. Use a plugin like **Insert Headers and Footers** or go to **Appearance → Theme Editor**
2. Paste the embed code before the closing `</body>` tag:

```html theme={null}
<script
  src="https://cdn.tinytalk.ai/latest/tiny-talk-sdk.min.umd.js"
  data-tiny-bot-id="YOUR_BOT_ID"
  defer
></script>
```

You can also add the script to a **Custom HTML** block on any individual page.

<Info>
  The manual approach only supports a single agent across your entire site. Use the plugin if you need per-page agents, rules, or shortcodes.
</Info>