Settings

WordPress (self-hosted)

Publish approved articles straight to any self-hosted WordPress site via the official REST API. myHERALD converts your markdown to clean HTML, uploads the featured image to your WP media library, and creates the post — saved as a Draft by default so you can review in WP Admin before going live.

Before you start

  • A self-hosted WordPress site (wordpress.org). WordPress 5.6+ ships Application Passwords in core; older versions need the plugin.
  • The WP user you connect with needs the Author capability or higher to create posts.
  • An Application Password generated in your WP profile (next step).

Generate an Application Password

  1. Log into your WordPress site as the user you want myHERALD to publish as.
  2. Go to Users → Profile.
  3. Scroll to Application Passwords.
  4. Type a name (e.g. "myHERALD") and click Add New Application Password.
  5. WordPress shows you a 24-character password once — copy it now. You won't see it again.

Connect it in myHERALD

  1. Open Settings → Integrations and find the WordPress card.
  2. Click Add site.
  3. Paste your site URL (e.g. https://blog.example.com), the WP username, and the Application Password you just generated.
  4. Save. myHERALD verifies the credentials by hitting your /wp-json/wp/v2/users/me endpoint.

Publishing

From the publish dialog you choose Draft (default) or Publish now. Draft is the safe default: the post lands in WP Admin → Posts ready for human review, with featured image attached, excerpt auto-generated from the body, and clean HTML rendering of all markdown — headings, lists, bold, italic, links, code blocks, tables.

What you can do

  • Publish posts to any self-hosted WordPress site.
  • Markdown rendered to native HTML — headings, lists, links, code blocks, tables preserved.
  • Featured-image upload to /wp-json/wp/v2/media before the post is created.
  • Choose Draft or Publish Now per post.
  • Auto-generated excerpt from the body.
  • Multiple sites per workspace via separate credentials.

Troubleshooting

"401 Unauthorized" on connect. Either the username is wrong, the Application Password has a typo (they're displayed with spaces every 4 chars — copy the whole thing including spaces, or strip them all), or your site is behind HTTP Basic auth at the server level which intercepts the WP auth header.

"403 Forbidden" on publish. The connected WP user doesn't have Author capability or higher. Either upgrade the role in WP Admin → Users, or generate a new Application Password under a user that does.

Featured image upload fails. Check that the WP user's role allows upload_files (Author and above do by default), and that the file size is within your WP install's upload limit (php.ini upload_max_filesize).

Post body looks plain text. myHERALD sends rendered HTML — if your theme strips block markup, install or activate Gutenberg/Classic Editor consistently. Already-published posts can be re-saved in WP to refresh.

Disconnect

Each connected WordPress site has its own kebab menu in Settings → Integrations → WordPress. Pick Disconnect to remove the credentials from myHERALD. To revoke from WP's side too, log in to that site, go to Users → Profile → Application Passwords, and revoke the "myHERALD" entry.

Was this page helpful?