Wordpress

Wordpress Integration

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

• Contact support at [email protected]