> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useupbeat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress

> Connect WordPress to publish and schedule articles directly from UPBEAT OS.

Connecting WordPress lets you publish articles from the UPBEAT OS article editor directly to your WordPress site — immediately or on a schedule. No copy-paste, no reformatting. The article lands on your site exactly as you wrote it.

## What this integration enables

Once connected, you can:

* **Publish articles** directly from the article editor at `/app/articles/write`
* **Schedule posts** to go live at a specific date and time
* **Select a post status** (Draft, Pending Review, or Published) so you can send to WordPress even if you want someone to review it there first
* View published articles in your Content Planner's Published column with a link to the live post

## Prerequisites

* A self-hosted WordPress site (WordPress.com is not supported)
* An account on your WordPress site with Author, Editor, or Administrator role
* The WordPress REST API must be enabled (it is by default on all modern WordPress installations)

## How to connect

<Steps>
  <Step title="Open Settings and scroll to **Integrations**">
    Navigate to [/app/settings](https://useupbeat.com/app/settings) in UPBEAT OS.
  </Step>

  <Step title="Find the WordPress card">
    Scroll to the WordPress section and click **Connect**.
  </Step>

  <Step title="Enter your WordPress URL">
    Type your website's full URL, including `https://` — for example, `https://yourdomain.com`. Don't include a trailing slash or a specific page path.
  </Step>

  <Step title="Enter your credentials">
    You'll be asked for a username and an **Application Password** (not your regular login password). To create an Application Password in WordPress:

    1. Log into your WordPress admin
    2. Go to Users → Your Profile
    3. Scroll to the **Application Passwords** section
    4. Enter a name (e.g., "UPBEAT OS") and click **Add New Application Password**
    5. Copy the generated password — you won't be able to see it again
  </Step>

  <Step title="Confirm the connection">
    Paste the Application Password into UPBEAT OS and click Connect. The WordPress card should show a green **Connected** status with your site URL.
  </Step>
</Steps>

## What you'll see once connected

A **Publish to WordPress** option becomes available in the article editor sidebar. When you publish:

* The article title becomes the post title
* The article body is sent as the post content (HTML)
* Your meta description (if set) is used as the SEO meta description (requires a compatible SEO plugin like Yoast or RankMath on your WordPress site)
* You choose whether to publish immediately or schedule for a specific date and time

## How to disconnect

Open Settings and scroll to **Integrations**, find the WordPress card, and click **Disconnect**. The publish option will no longer appear in the article editor. Your previously published articles remain live on your WordPress site.

## Troubleshooting

**"Connection failed" error:** Double-check that your WordPress URL is correct and includes `https://`. Verify that you used an Application Password, not your regular WordPress login password. If your site has a security plugin (like Wordfence), it may be blocking the API request — check your plugin's firewall settings.

**Articles appear but formatting looks off:** WordPress may be stripping some HTML formatting. Check your WordPress theme's content rendering settings, or try disabling any "content filtering" features in your active plugins.

**Can't find the Application Passwords section:** Application Passwords require WordPress 5.6 or later. Update WordPress if you're on an older version. Some security plugins also disable this feature — check your plugin settings.