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

> ## Agent Instructions
> PostQueen's hosted API is https://api.postqueen.ai. The public API base is https://api.postqueen.ai/public/v1 and takes the raw API key in the Authorization header, with no Bearer prefix.
> The MCP server for posting is https://api.postqueen.ai/mcp/YOUR_API_KEY (or /mcp with Authorization: Bearer YOUR_API_KEY). docs.postqueen.ai/mcp only searches these docs and cannot post.
> The API key is under Connections > API Keys in the app, and only workspace admins can see it.

# WordPress

> Connect a WordPress site to PostQueen with an Application Password, what you can publish to it, and the limits PostQueen checks before a post is scheduled.

export const ChannelStatus = ({status, children}) => {
  const look = ({
    available: {
      color: 'green',
      label: 'Available'
    },
    'in-review': {
      color: 'yellow',
      label: 'In review'
    },
    soon: {
      color: 'gray',
      label: 'Soon'
    }
  })[status] || ({
    color: 'gray',
    label: status
  });
  return <div className="pq-status not-prose" data-status={status}>
      <Badge color={look.color} shape="pill" size="md">{look.label}</Badge>
      {children ? <span className="pq-status-note">{children}</span> : null}
    </div>;
};

<ChannelStatus status="available" />

Publish posts, pages or any custom post type to your WordPress site on schedule, or hand them over as drafts, with a title, formatted body, featured image, categories and tags. You connect with the site address, your username and an Application Password, and no plugin is needed.

<div className="pq-visual pq-visual-card pq-tint-lilac">
  <img noZoom src="https://mintcdn.com/forceplay/CEQwaAjYodG7Gh_r/images/site/channels/wordpress.webp?fit=max&auto=format&n=CEQwaAjYodG7Gh_r&q=85&s=cd7574f662a2328aa795f74ccc738a51" alt="A new WordPress post in the PostQueen composer, with the post types WordPress takes and the time it goes out" width="1200" height="1078" data-path="images/site/channels/wordpress.webp" />
</div>

## What you can post

<CardGroup cols={2}>
  <Card title="Text" icon="type">
    A body of up to 100,000 characters with headings, bold, underline, lists and links, and a title of at least 2 characters.
  </Card>

  <Card title="Media" icon="image">
    One featured image, uploaded to your media library. Pictures inside the body are not uploaded.
  </Card>

  <Card title="Post types" icon="layers">
    A post, a page or any custom post type your site offers, published, saved as a draft, sent for review or kept private.
  </Card>

  <Card title="Analytics" icon="chart-line">
    No analytics for WordPress.
  </Card>
</CardGroup>

**Not supported:** excerpts, WordPress's own scheduled status (PostQueen publishes at the time instead), video or audio uploads, images inside the body, and follow-up comments.

## Checked before scheduling

PostQueen refuses a post that breaks these rules and shows the message in the composer:

| Rule                             | Message                                              |
| -------------------------------- | ---------------------------------------------------- |
| A title of at least 2 characters | “title must be longer than or equal to 2 characters” |
| A post type is picked            | “type should not be null or undefined”               |
| Text within 100,000 characters   | “post is too long, please fix it”                    |

The size of the featured image is your site's rule, and PostQueen does not check it first: your server's upload limit applies.

## Connect WordPress

Your site's REST API has to be reachable from the internet, and the WordPress user has to be allowed to create posts. WordPress offers Application Passwords by default only on sites served over `https`.

<Steps>
  <Step title="Create an Application Password">
    In your WordPress admin, open **Users**, then **Profile**, and scroll to **Application Passwords**. Name it `PostQueen`, choose **Add New Application Password**, and copy the generated password. WordPress shows it only once.
  </Step>

  <Step title="Open Add Channel">
    In PostQueen, open **Channels** and choose **Add Channel**, then **WordPress** and **Enter details**.
  </Step>

  <Step title="Enter the site and the login">
    Type the site root in **Domain URL**, for example `https://example.com`, your WordPress username in **Username**, and the Application Password, spaces and all, in **Password**. Choose **Connect**.
  </Step>

  <Step title="Check that it connected">
    The channel appears in the **Channels** list with your WordPress avatar and name.
  </Step>
</Steps>

Your login password does not work here: WordPress takes only an Application Password for this kind of access.

<Warning>
  **Never share your API keys, passwords or access tokens with anyone, including PostQueen staff.**

  A key, app password or private key a channel asks for goes into its connect form in PostQueen and nowhere else. Nobody from PostQueen will ask you to send one by email or chat, and you can disconnect the channel at any time.
</Warning>

## Post settings

Each WordPress post in the composer has these settings:

* **Title**: required, at least 2 characters. The post's address (its slug) is made from it.
* **Select type**: required. Where the post goes: a post, a page or a custom post type from your site.
* **Status**: **Publish**, **Draft**, **Pending** (sent for review) or **Private**. It starts on **Publish**.
* **Categories** and **WordPress Tags**: picked from your site. The first 100 of each are listed.
* **Cover picture**: the featured image.

At the scheduled time PostQueen sends the post with the status you picked, so **Publish** puts it live and **Draft** leaves it in WordPress for you to finish. The field names and values for the API are on [WordPress posting settings](/public-api/providers/wordpress).

## Comments and threads

WordPress takes no follow-up comments, so the composer shows no **Add comment** button for a WordPress post.

## Good to know

* Only sites reachable on the public internet can be connected. An address on a private or local network is refused.
* A security plugin or a server setting that blocks the REST API, or strips the Authorization header, makes the connect fail with a message that says so.
* If you revoke the Application Password, publishing stops. Create a new one and enter it with **Update Credentials** under **Access** on the channel's page.
* **Invite by link** does not offer WordPress, because the Application Password is typed into PostQueen. Connect it with **Connect myself**.
* During the free trial, a WordPress account that another PostQueen workspace already connected is refused until you end the trial.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Could not reach your WordPress site. Check the Domain URL and that the site is publicly accessible.">
    PostQueen could not open the site. Check **Domain URL**, including `https`, and that the site loads from outside your network.
  </Accordion>

  <Accordion title="WordPress rejected the login. A security plugin or server setting may be blocking the REST API or stripping the Authorization header, or the username / Application Password is incorrect.">
    Check the username and paste the Application Password again. If both are right, allow the REST API and the Authorization header in your security plugin or server settings.
  </Accordion>

  <Accordion title="WordPress did not return a valid response. The REST API may be disabled or blocked by a security plugin.">
    The site answered with a page instead of REST API data, often a security or maintenance plugin. Allow the REST API and connect again.
  </Accordion>

  <Accordion title="The connect user has insufficient permissions to create posts">
    The WordPress user cannot create posts of the type you picked. Give it a role such as Author or Editor, or connect with another user.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Create a post" icon="square-pen" href="/using/create-a-post">
    Write once for several channels, then schedule it, save a draft or post now.
  </Card>

  <Card title="Channels and their status" icon="layout-grid" href="/channels/overview">
    Which networks you can connect today, what each one posts, and its text limit.
  </Card>

  <Card title="Post from an AI agent" icon="bot" href="/agents/overview">
    Ask Claude, ChatGPT, Grok Bot or another agent to schedule the post for you.
  </Card>

  <Card title="A post did not go out" icon="triangle-alert" href="/troubleshooting/post-failed">
    Why a post fails and what to do about it.
  </Card>
</CardGroup>