Browse the docs

DocsConnect channels

WordPress

Connect a WordPress site with an application password and publish posts or pages with categories, tags and a featured image.

On this page

What you need

  • A WordPress site that is reachable from the internet, with the REST API turned on.
  • A WordPress user that is allowed to create posts.
  • An application password for that user. Create it in WordPress under Users, Profile, Application Passwords. Application passwords are a built-in WordPress feature. Some hosts and security plugins turn them off.

Connect

  1. On the calendar page choose Add Channel, then WordPress.
  2. Fill in the fields:
FieldWhat to enter
Domain URLThe full address of your site, for example https://example.com. A trailing slash is removed for you.
UsernameThe WordPress username.
PasswordThe application password, not your login password.
  1. Save. PostDelegate calls your site’s REST API to check the details.

If the connection fails you will see one of these messages:

  • Could not reach your WordPress site. Check the address, and that the site is public.
  • WordPress rejected the login. The username or application password is wrong, or a security plugin or server setting is blocking the REST API or stripping the Authorization header.
  • The REST API may be disabled or blocked. Turn the REST API on or allow it in your security plugin.

Post settings

SettingNotes
TitleRequired, at least 2 characters.
Post typeRequired. Choose from the types on your site, such as posts and pages.
StatusPublish (the default), Draft, Pending or Private.
CategoriesOptional. Loaded from your site.
TagsOptional. Loaded from your site.
Main imageOptional featured image. It is uploaded to your media library.

Content

The editor writes HTML, up to 100,000 characters. Put pictures inside the content where they should appear, using images from the media library. Attachments are not published separately.

Troubleshooting

  • The connected user has insufficient permissions to create posts. Use a user with a role that can publish posts.
  • Categories or tags are empty. Your site returned none, or the REST API blocked the request.

Something unclear, wrong or missing? Email [email protected] and tell us which page you were on.