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

# WordPress

> Connect your WordPress site so agents can create, edit and publish posts and pages, and set SEO titles and meta descriptions, without driving the editor in a browser.

Connect your WordPress site once and an agent can write to it directly: save an article as a draft, publish it, change a page, fix a title tag or a meta description, add an image. It works through WordPress's own REST API with an **application password**, so it needs no plugin and no browser.

Works with self-hosted WordPress (5.6 or later) served over HTTPS. A site hosted on WordPress.com can be connected only if it offers application passwords; Connie tells you when a site does not.

## Connect your site

Ask an agent to work on your WordPress site (for example "publish this article on our WordPress site"). If no site is connected, it shows a connect card: click **Connect** on it.

**1. Enter your site address**

In **Connect WordPress**, enter the **Site address** (for example `https://example.com`) and click **Continue**. Connie checks that a WordPress site answers there. Nothing is signed in yet.

**2. Create an application password in WordPress**

Click **Create password in WordPress**. Your site opens in a new tab on its own screen for approving an application named **Connie**; approve it and copy the password WordPress shows. You can also create one yourself in WordPress under **Users → Profile → Application Passwords**.

**3. Enter it in Connie**

Back in Connie, enter your **WordPress username** and the **Application password**, then click **Connect**. Connie checks them against your site before saving.

The application password is not your WordPress login password. It only works for the REST API, and you can revoke it in WordPress at any time (**Users → Profile → Application Passwords**). Enter it only in this dialog: an agent never asks for it in a conversation, and Connie stores it encrypted.

Use a WordPress user with the **Editor** or **Administrator** role. Connie can do what that user can do with posts, pages and media, and nothing more: an **Author** can publish their own posts but cannot edit pages; a **Contributor** can only save drafts for review.

A new connection starts as **Only you**. To let teammates' requests use the site, share it under [Manage access](https://docs.connie.ai/tools/connect-accounts.md#choose-who-can-use-an-account). You can connect several sites; when more than one is connected, say which site you mean.

## What an agent can do

| Tool | What it does |
| - | - |
| **List WordPress Posts and Pages** | Finds posts and pages by words, slug or status, with their addresses. |
| **Read WordPress Post or Page** | Reads one post or page: its text, status, categories, tags and SEO title and meta description. |
| **Save WordPress Post or Page** | Creates a post or page, or changes one: text, title, slug, excerpt, categories, tags, featured image, SEO title and meta description, status. |
| **Upload Image to WordPress** | Adds an image to your media library from a public address, for a featured image or inside a post. |

* **Drafts and publishing.** New content is saved as a **draft** unless you asked to publish. Publishing makes it live at once; it can also be scheduled for a date and time, left pending review, or taken back to a draft.
* **Changing existing content.** Only the fields the agent changes are sent. It reads the page first, and its report says what the page said before. WordPress keeps the earlier version as a revision you can restore in the editor.
* **Categories and tags** are given by name; ones that do not exist are created if your WordPress user may create them.
* **Addresses.** The agent does not change the slug of live content unless you ask. When a slug changes, WordPress redirects the old address of a post by itself, but not of a page.

### SEO title and meta description

These are written through your site's SEO plugin. Connie reports for each field whether your site kept it.

| SEO plugin | Posts | Pages |
| - | - | - |
| Yoast SEO | Yes | No: Yoast accepts these fields through the REST API for posts only. |
| Rank Math | Yes | Yes |
| All in One SEO | Yes | Yes |
| SEOPress | Yes | Yes |
| None of these | No | No |

Without an SEO plugin, WordPress uses the post title as the title tag and prints no meta description. Where a field cannot be written this way (a page on a Yoast SEO site, for example), the agent says so and can set that one field in the WordPress editor with the [browser](https://docs.connie.ai/tools/overview.md) instead.

### What it does not do

Menus, theme and plugin settings, redirects, comments, custom post types and deleting content are not covered by these tools. An agent can still do those in the WordPress editor with the browser and its saved login.

## Approvals

* Saving a **new draft** and uploading an image run without an approval card: nothing a visitor can see changes.
* **Publishing, scheduling, and any change to a post or page that already exists** change your public website. Connie reviews each one like any other action outside Connie and may show an [approval card](https://docs.connie.ai/chat/approvals.md) before it runs.
* Listing and reading are free reads and never ask.

These tools cost no Connie credits. Workspace owners and admins can set any of them to ask every time or switch it off under [Tools and permissions](https://docs.connie.ai/tools/permissions.md).

## Troubleshooting

| What you see | What to do |
| - | - |
| "No WordPress REST API answered at that address." | Check the address. If it is right, a security plugin or firewall may be blocking `/wp-json/`; allow it. |
| "This site does not offer application passwords…" | Application passwords are switched off (some security plugins, such as Wordfence, disable them by default) or the site is not on HTTPS. Switch them on in WordPress. |
| "WordPress did not accept that username and application password." | Use an application password, not your login password, with the username it was created for. |
| "…may not edit content. Connect a user with the Editor or Administrator role." | The WordPress user is a Subscriber. Connect a user who can edit. |
| An agent says the site "no longer accepts the saved application password" | The password was revoked in WordPress. Connect the site again with a new one; the connection keeps its sharing. |
| "The site refused the request before WordPress answered it…" | A firewall (Cloudflare, Wordfence, a host rule) is blocking API requests. Allow requests to `/wp-json/` for signed-in users. |

If your site cannot be connected this way, an agent can still work in the WordPress editor through the browser with its saved login.

## Related

* [Connect accounts](https://docs.connie.ai/tools/connect-accounts.md)
* [Skills](https://docs.connie.ai/skills/overview.md): the four search skills that write, publish and verify pages on your site
* [Approvals](https://docs.connie.ai/chat/approvals.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.