# Wordpress

## WordPress Integration

Publish your AI-generated articles directly to WordPress with one click. Cuppa's WordPress integration works with any WordPress site — self-hosted, WordPress.com, or managed hosting.

### What You Can Do

* **Auto-publish articles** to WordPress as they're generated
* **Publish as draft or live** — you choose the default
* **Featured images** are automatically uploaded
* **SEO metadata** transfers (titles, meta descriptions, slugs)
* **Categories and tags** are included
* **Bulk publish** multiple articles at once

***

### Prerequisites

Before connecting, you'll need:

1. A **WordPress site** (self-hosted, WordPress.com, or any host)
2. **Administrator access** to your WordPress site
3. The **Cuppa Plugin** installed on your WordPress site

***

### Step 1: Install the Cuppa Plugin

#### Option A: From WordPress Plugin Directory

1. Log in to your **WordPress Admin**
2. Go to **Plugins** → **Add New**
3. Search for **"Cuppa"**
4. Click **Install Now**
5. Click **Activate**

#### Option B: Manual Installation

1. Download the Cuppa plugin from the WordPress plugin directory
2. Upload to `/wp-content/plugins/`
3. Activate in **Plugins** → **Installed Plugins**

***

### Step 2: Get Your Connection Token

After activating the plugin:

1. In WordPress, go to **Settings** → **Cuppa**
2. Click **Generate Token**
3. **Copy the token** — you'll need this in Cuppa

> 💡 **Tip**: The token is tied to your WordPress user. Use an admin account for full publishing permissions.

***

### Step 3: Connect WordPress in Cuppa

1. Go to **Site Settings** → **Integrations**
2. Find **WordPress** and click **Connect**
3. Enter your:
   * **WordPress Site URL** (e.g., `https://myblog.com`)
   * **Connection Token** from Step 2
4. Click **Connect**

Cuppa will verify the connection before saving.

***

### Step 4: Configure Publishing Settings

After connecting, configure your defaults:

#### Auto-Publishing

* **Enable**: Articles publish to WordPress automatically when generated
* **Disable**: Articles are only published when you manually trigger it

#### Default Post Status

* **Draft**: Articles are saved as drafts (recommended for review)
* **Published**: Articles go live immediately
* **Pending**: Articles need editor approval

#### Default Category

Select which WordPress category new posts should be assigned to.

#### Default Author

Choose which WordPress user is credited as the author.

***

### How It Works

#### Manual Publishing

1. Open any article in Cuppa
2. Click **Publish to WordPress**
3. (Optional) Adjust post status, category, or author
4. Click **Publish**
5. Your article appears in WordPress

#### Auto-Publishing

1. Generate an article in Cuppa
2. Article automatically sends to WordPress
3. Appears with your default status (draft/published/pending)

#### Bulk Publishing

1. Go to your articles list
2. Select multiple articles
3. Click **Bulk Actions** → **Publish to WordPress**
4. All selected articles are queued for publishing

***

### What Gets Published

| From Cuppa       | To WordPress                                  |
| ---------------- | --------------------------------------------- |
| Title            | Post title                                    |
| Content          | Post content (HTML)                           |
| Slug             | URL slug (permalink)                          |
| Excerpt          | Post excerpt                                  |
| Meta Title       | SEO title (if Yoast/RankMath installed)       |
| Meta Description | SEO description (if Yoast/RankMath installed) |
| Featured Image   | Featured image                                |
| Categories       | Post categories                               |
| Tags             | Post tags                                     |

***

### SEO Plugin Compatibility

Cuppa works with popular WordPress SEO plugins:

| Plugin             | SEO Fields Supported                          |
| ------------------ | --------------------------------------------- |
| **Yoast SEO**      | ✅ Meta title, meta description, focus keyword |
| **Rank Math**      | ✅ Meta title, meta description, focus keyword |
| **All in One SEO** | ✅ Meta title, meta description                |
| **SEOPress**       | ✅ Meta title, meta description                |

SEO data is automatically populated when these plugins are detected.

***

### Troubleshooting

#### "Connection failed" error

**Check your WordPress URL:**

* Include `https://` at the start
* Don't include a trailing slash
* Use your actual domain (not a redirect)
* Example: `https://myblog.com` ✓ not `https://myblog.com/` ✗

**Check your token:**

* Ensure you copied the full token
* Regenerate the token if needed
* Make sure the token was generated by an admin user

**Plugin issues:**

* Verify the Cuppa plugin is activated
* Check for plugin conflicts (disable other plugins temporarily)
* Ensure WordPress is updated to a recent version

#### "Authentication failed" error

* Your token may have been regenerated
* Go to WordPress → Settings → Cuppa
* Generate a new token and update in Cuppa

#### "Publishing failed" error

**Permission issues:**

* Ensure the WordPress user has publish permissions
* Check your user role (admin or editor required)

**Content issues:**

* Very long articles may hit server limits
* Check for special characters that may cause issues
* Ensure images are publicly accessible

#### Articles not appearing in WordPress

* Check if they're saved as drafts (look in Posts → All Posts → Drafts)
* Verify the post status setting in Cuppa
* Check WordPress for any pending review posts

#### Featured images not showing

* Ensure your WordPress theme supports featured images
* Check image file size (some hosts limit uploads)
* Verify the image URL is publicly accessible

#### Formatting looks different

* WordPress themes apply their own styles
* Check your theme's content styles
* Some HTML elements may be styled differently

***

### Best Practices

#### 1. Use Draft Mode First

When starting out, set your default status to "Draft." Review AI-generated content before publishing.

#### 2. Set Up Categories in WordPress

Create your category structure in WordPress first, then select default categories in Cuppa.

#### 3. Review SEO Settings

If using Yoast or RankMath, review the SEO data after publishing. Cuppa sends the data, but you may want to fine-tune it.

#### 4. Test with One Article

Before bulk publishing, test with a single article to ensure formatting and settings are correct.

#### 5. Keep the Plugin Updated

Update the Cuppa WordPress plugin when new versions are available for best compatibility.

***

### FAQ

**Does it work with WordPress.com?** Yes, for WordPress.com Business plans and higher that allow plugins. Free and Personal plans don't support plugins.

**Does it work with Elementor/Divi/other builders?** Articles are published as standard WordPress posts. You can then edit them with page builders if needed.

**Can I publish to pages instead of posts?** Currently, Cuppa publishes to posts only. Page support may be added in the future.

**Will it update existing posts?** Currently, Cuppa creates new posts. To update, delete the post in WordPress and republish from Cuppa.

**Can I publish to multiple WordPress sites?** Each Cuppa site connects to one WordPress site. Create additional sites in Cuppa for additional WordPress blogs.

**Does it support custom post types?** Currently, standard posts only. Custom post type support may be added in the future.

**What about Gutenberg blocks?** Content is published as classic editor HTML, which works in Gutenberg. Native block conversion may come in the future.

**Can I schedule posts?** Posts are published immediately with the selected status. Use WordPress's built-in scheduling after the post is created.

**Does it work with multisite?** Yes, connect each subsite separately in Cuppa.

**Is there a limit to how many articles I can publish?** No limit from Cuppa. Your WordPress hosting may have its own limits.

***

### Disconnecting

To disconnect WordPress:

1. Go to **Site Settings** → **Integrations**
2. Click **Disconnect** on your WordPress integration

Your existing posts in WordPress remain unchanged. The Cuppa plugin can be deactivated or removed from WordPress.

***

### Related Features

* Bulk Article Generation — Generate multiple articles at once
* Content Planner — Plan and schedule your content
* AI Images — Generate featured images for your posts

***

### Need Help?

* Check our [Help Center](https://learn.cuppa.ai)
* Contact support at <support@cuppa.ai>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.cuppa.ai/integrations/wordpress.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.