Docs
WordPress
Publish articles to your WordPress blog and the inner pages from your topical map as WordPress pages, with the Blogr plugin — installed once, connected with a single token.
How it works
The Blogr plugin adds a small, token-protected endpoint to your WordPress site. When you publish an article in blogr.ai, we send it there and the plugin creates it as a WordPress post — featured image and article images downloaded into your media library, SEO fields filled in for Yoast SEO or Rank Math. Traffic flows one way: your site never sends content to us.
Connect your site
- In your WordPress admin, go to Plugins → Add New Plugin, search for "Blogr", then install and activate. You can also browse the listing on WordPress.org.
- In your blogr.ai dashboard, open Setup → Publishing and choose WordPress.
- Enter your WordPress site URL — with https, e.g. https://example.com.
- Copy the integration token we generate for you.
- In your WordPress admin, go to Settings → Blogr, paste the token, and save.
- Back in blogr.ai, click Send test to verify the connection, then Save. Saving checks the connection too — it only succeeds once your site answers with the right token.
A website publishes to one destination: connecting WordPress replaces any other integration on that website.
What gets created
- Each article becomes a regular WordPress post. New posts arrive as drafts by default — switch to "Published immediately" under Settings → Blogr if you'd rather skip the review step.
- Inner pages from your topical map (pricing, comparisons, services, locations) become WordPress pages at the path the map designed — /pricing/ lands at /pricing/, /compare/acme-alternatives/ nests under your /compare/ page when you have one and sits at the top level otherwise. Pages follow the same draft-or-publish setting and carry no categories or tags. Needs plugin 1.3.0 or newer.
- The article's share image becomes the post's featured image, and any images in the article body are downloaded into your media library, so nothing on your site depends on blogr.ai's servers.
- With Yoast SEO or Rank Math active, the SEO title, meta description, and focus keyword are filled in automatically.
- Categories and tags generated with the article (up to 3 each) are assigned to the post — existing terms are reused by name, missing ones created. An article without them leaves your categorization untouched.
- Posts are attributed to the author you pick under Settings → Blogr, or your first administrator by default.
Staying up to date
Updates come from WordPress.org, the same place every other plugin on your site gets them. New versions appear on your Plugins screen: one click to update, or turn on "Enable auto-updates" on the plugin row and your site installs them for you.
Installed an older copy of the plugin by uploading a ZIP? Update it once from your Plugins screen and your site picks up WordPress.org releases from then on.
Republishing
Publishing an article again updates the same WordPress post — never a duplicate. The title, content, and SEO fields refresh to the latest version, while the post's status and permalink are preserved: a post you've already published stays published, and a slug you've tuned stays put.
Troubleshooting
| Symptom | Fix |
|---|---|
| "Your WordPress site rejected the token" (401) | The token in Settings → Blogr doesn't match. Copy it again from Setup → Publishing — the whole value, no spaces — paste it in WordPress, and save. |
| "The Blogr plugin didn't answer" (404) | Check the plugin is installed and activated, and that your permalinks aren't set to "Plain" (Settings → Permalinks — any other option works). |
| "Your WordPress site blocked the request" (403) | A security plugin or firewall is filtering REST API requests. Allow requests to /wp-json/blogr/v1 in its settings. |
| Could not reach your site | Confirm the URL is exactly your site's address with https and that the site is online. blogr.ai can't deliver to private or internal addresses. |
A failed delivery marks the article "Failed to publish" in your workspace with the reason on the article row. Nothing is lost — fix the issue and click Retry publish.
Security
- Every request to the plugin carries your integration token in an X-Blogr-Token header; the plugin rejects anything else with a 401.
- The token is generated for you and stored encrypted — treat it like a password, and rotate it anytime by entering a new value in Setup → Publishing and updating Settings → Blogr to match.
- Your site must be served over https. blogr.ai refuses to deliver to private or internal addresses.