WordPress Integration

Publish your AI-generated articles directly to WordPress with one click. Cuppa talks to WordPress over the REST API — no Cuppa plugin required. Works with self-hosted WordPress, WordPress.com (Business+), and managed hosts.

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

---

Use an Editor account, not Administrator

Cuppa publishes posts, pages, and images. The Editor role covers all of that. Administrator is more access than the integration uses. Do not paste an Administrator username or password into Cuppa.

Role	Use it?	Why
Editor	Yes	Posts, pages, media, categories. This is the role Cuppa needs.
Administrator	No	Extra access Cuppa never calls (users, plugins, settings). Do not connect it.

Best practice: Create a dedicated WordPress user (e.g. cuppa-publisher) with the Editor role, then generate the application password on that user. Someone with Administrator access can create that user once. The credentials you enter in Cuppa must be the Editor’s, not the admin’s.

---

Prerequisites

Before connecting, you’ll need:

1. A WordPress site (self-hosted 5.6+, WordPress.com Business+, or any host with the REST API enabled)
2. A dedicated Editor user on that site (not Administrator)
3. An application password generated on that Editor user

You do not need the Cuppa WordPress plugin.

---

Step 1: Create a dedicated Editor user

If you already have a dedicated Editor for Cuppa, skip this.

1. Log in to WordPress (an Administrator does this once)
2. Go to Users → Add New User
3. Create a user such as cuppa-publisher
4. Set the role to Editor
5. Save

Do not reuse your personal Administrator login.

---

Step 2: Generate an application password

Generate the password on the Editor user, not on an Administrator.

1. In WordPress, go to Users → edit the Editor (cuppa-publisher), or sign in as that user and open Users → Profile
2. Scroll to Application Passwords
3. Name it clearly (e.g. Cuppa or cuppa-2026-q3)
4. Click Add New Application Password
5. Copy the password — WordPress shows it once

Application passwords inherit the user’s role. Editor on the user = Editor on the key. That is why the user must not be Administrator.

Official reference: WordPress application passwords.

If Application Passwords is missing, a security plugin or host has usually disabled it. See Troubleshooting and the connection FAQ.

---

Step 3: Connect WordPress in Cuppa

1. Go to Site Settings → Integrations (or Team Settings → Integrations)
2. Find WordPress and click Connect
3. Enter:
   • WordPress Site URL (e.g. https://myblog.com)
   • Username of the Editor (username or email)
   • Application password from Step 2
4. Click Connect

Cuppa will verify the connection before saving.

URL format:

Use	Don’t use
https://example.com	example.com (missing https://)
https://example.com/en	https://example.com/wp-admin
https://www.example.com if that is the real site	https://example.com/wp-login.php
	Trailing slash (https://example.com/)

---

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. An Editor connection can fall back to the connected user if it cannot list other authors.

---

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
• Don’t use /wp-admin or /wp-login.php
• Use your actual domain (not a redirect)
• Example: https://myblog.com ✓ not https://myblog.com/ ✗

Check the user and password:

• Username is the Editor account, not an Administrator
• You pasted the full application password
• The application password was generated on that same Editor user
• Generate a new application password if needed

REST API / host issues:

• Application Passwords and the REST API must be enabled
• Security plugins often block application passwords or /wp-json/
• Temporarily disable security plugins to test, then allowlist the REST API
• Ask your host to check server logs if the request never reaches WordPress

”Authentication failed” error

• The application password may have been revoked or regenerated
• In WordPress, generate a new application password on the Editor user
• Update it in Cuppa — do not switch to an Administrator password to “fix” it

”Publishing failed” error

Permission issues:

• The connected user must be Editor
• Confirm the role in WordPress → Users

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. Dedicated Editor, never admin

Create cuppa-publisher (Editor). Generate application passwords only on that user. If someone with Administrator access leaves, you revoke the Editor key — you never handed Cuppa the admin login.

2. Rotate the application password quarterly

New password → update Cuppa → test a draft → revoke the old password in WordPress. See Brand Engineer Workspace Best Practices.

3. Use Draft Mode First

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

4. Set Up Categories in WordPress

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

5. 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.

6. Test with One Article

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

---

FAQ

Do I need the Cuppa WordPress plugin? No. Cuppa uses the WordPress REST API and an application password.

Do I need Administrator credentials? No. Create an Editor user and connect that. Administrator is more access than publishing uses.

Does it work with WordPress.com? Yes, for WordPress.com Business plans and higher that allow the REST API and application passwords. Free and Personal plans typically do not.

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? Cuppa can publish posts and pages. Default article publishing is posts.

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 and pages. 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. Each connection should use an Editor on that subsite.

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

What if Application Passwords is disabled? Security plugins and some hosts turn this off. Enable it for the Editor user, or export via CSV and import if the host will not allow REST publishing. See the connection FAQ.

---

Disconnecting

To disconnect WordPress:

1. Go to Site Settings → Integrations
2. Click Disconnect on your WordPress integration
3. In WordPress, revoke the application password on the Editor user

Your existing posts in WordPress remain unchanged.

---

Related Features

• Brand Engineer Workspace Best Practices - Rotate CMS credentials quarterly
• 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?

• I can’t connect my WordPress site
• Contact support at support@cuppa.ai