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:
- A WordPress site (self-hosted, WordPress.com, or any host)
- Administrator access to your WordPress site
- The Cuppa Plugin installed on your WordPress site
Step 1: Install the Cuppa Plugin
Option A: From WordPress Plugin Directory
- Log in to your WordPress Admin
- Go to Plugins → Add New
- Search for “Cuppa”
- Click Install Now
- Click Activate
Option B: Manual Installation
- Download the Cuppa plugin from the WordPress plugin directory
- Upload to
/wp-content/plugins/ - Activate in Plugins → Installed Plugins
Step 2: Get Your Connection Token
After activating the plugin:
- In WordPress, go to Settings → Cuppa
- Click Generate Token
- 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
- Go to Site Settings → Integrations
- Find WordPress and click Connect
- Enter your:
- WordPress Site URL (e.g.,
https://myblog.com) - Connection Token from Step 2
- WordPress Site URL (e.g.,
- 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
- Open any article in Cuppa
- Click Publish to WordPress
- (Optional) Adjust post status, category, or author
- Click Publish
- Your article appears in WordPress
Auto-Publishing
- Generate an article in Cuppa
- Article automatically sends to WordPress
- Appears with your default status (draft/published/pending)
Bulk Publishing
- Go to your articles list
- Select multiple articles
- Click Bulk Actions → Publish to WordPress
- 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✓ nothttps://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:
- Go to Site Settings → Integrations
- 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 support@cuppa.ai