WordPress

WordPress Integration

Connect Casper with your WordPress site to automatically publish SEO-optimized articles directly to your blog.

Overview

The WordPress integration allows you to publish articles directly to your WordPress blog or website. Casper uses the WordPress REST API to create posts, set categories, add tags, and configure SEO metadata.

Requirements: WordPress 5.0 or higher with REST API enabled. You'll need an application password for authentication.

Setup Instructions

Step 1: Create an Application Password

  1. Log in to your WordPress admin dashboard
  2. Go to Users → Profile (or Users → Your Profile)
  3. Scroll down to the Application Passwords section
  4. Enter a name for the application (e.g., "Casper")
  5. Click Add New Application Password
  6. Copy the generated password (you won't be able to see it again)

Step 2: Connect in Casper

  1. Go to Settings → Integrations in your Casper dashboard
  2. Click Connect next to WordPress
  3. Enter your WordPress site URL (e.g., https://yoursite.com)
  4. Enter your WordPress username
  5. Paste the application password you created
  6. Click Test Connection to verify
  7. Click Save to complete the connection

Step 3: Configure Publishing Settings

After connecting, you can configure:

  • Default post status (Draft, Publish, or Scheduled)
  • Default author
  • Default categories and tags
  • Featured image settings

How to Use

Publishing Articles

When you're ready to publish an article, click the Publish button on any article. Select WordPress from the list of connected platforms, choose your publishing options (categories, tags, featured image), and click Publish. The article will be created on your WordPress site immediately.

Scheduling Content

You can schedule articles to be published at a specific date and time. When scheduling, Casper will create the post in WordPress as a scheduled post, and WordPress will automatically publish it at the specified time.

Managing Published Content

All published articles are tracked in Casper. You can see which articles have been published to WordPress and when. If you need to make changes, you can edit the article in Casper and republish, or edit directly in WordPress.

Troubleshooting

Connection Failed

If you're having trouble connecting:

  • Make sure your WordPress URL includes https:// or http://
  • Verify that REST API is enabled (it should be by default in WordPress 5.0+)
  • Double-check your username and application password
  • Ensure your WordPress site is accessible from the internet

Publishing Errors

If articles aren't publishing:

  • Check that your WordPress connection is still active
  • Verify you have permission to create posts
  • Make sure the categories and tags you're using exist in WordPress
  • Check WordPress error logs for more details

Formatting Issues

If content formatting looks incorrect in WordPress, it may be due to your theme's styling. Casper publishes content as HTML, which WordPress will render according to your theme. You can always edit the post in WordPress to adjust formatting.

Yoast SEO Meta Fields Not Updating

If you're using Yoast SEO and notice that meta descriptions, SEO titles, or focus keywords aren't being set automatically, this is due to WordPress REST API limitations with protected meta fields.

Solution: Install the wp-api-yoast-meta plugin:

  1. Go to your WordPress admin dashboard
  2. Navigate to Plugins → Add New
  3. Search for "wp-api-yoast-meta" or install it from GitHub
  4. Activate the plugin
  5. Republish an article from Casper to test

This plugin enables the WordPress REST API to write Yoast SEO metadata, allowing Casper to automatically set meta descriptions, SEO titles, and focus keywords when publishing articles.

Note: After installing the plugin, you may need to republish existing articles for the Yoast metadata to be set. New articles published after installation will automatically include Yoast SEO fields.

Common Questions

Can I use WordPress.com?

Yes! WordPress.com sites support the REST API and application passwords. Follow the same setup process.

Do I need a plugin?

For basic publishing, no plugins are required—Casper uses WordPress's built-in REST API. However, if you're using Yoast SEO and want meta descriptions, SEO titles, and focus keywords to be set automatically, you'll need to install the wp-api-yoast-meta plugin (see the Yoast SEO troubleshooting section above).

Can I connect multiple WordPress sites?

Each organization represents one website and can only have one integration connected. If you want to connect multiple WordPress sites, create separate organizations for each site. Each organization has its own settings, integrations, and content.

Related Topics