WordPress — Docs

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.
Pick a menu under Settings → Blogr → "Add site pages to menu" and each top-level page (a hub such as /compare/, or a single page such as /pricing/) joins it when it goes live, so visitors and search engines can reach it from your site. Pages under a hub are linked from the hub, and a page you remove from the menu stays removed. Needs plugin 1.5.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.

Designed pages

Some inner pages are built as landing pages: a hero with buttons, feature cards, numbered steps, a comparison table, an FAQ, and a closing call to action. With plugin 1.6.0 or later they arrive with a small stylesheet that loads on those pages only. Every rule is scoped to the page's own content, so your theme and the rest of your site stay exactly as they are. Fonts and text colors come from your theme.

A new designed page takes your theme's full-width template when it has one, and opens in the block editor as a Custom HTML block. On an older plugin version the same page arrives unstyled but still reads as a clean, ordered page; update the plugin to get the layout.

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.

When your topical map rewrites a page that is already on your site, the article carries that page's address and the plugin (1.4.0 or later) updates the live post in place, so the rewrite keeps the original URL. A post the map replaces at a new URL moves there, and WordPress redirects its old address.

Troubleshooting

Symptom	Fix
"Your WordPress site rejected the token" (401)	The token in Settings → Blogr doesn't match. Click Regenerate token in Setup → Publishing, copy the new value (the whole value, no spaces), paste it in WordPress and save, then save in blogr.ai.
"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 with Regenerate token in Setup → Publishing, then update Settings → Blogr to match before you save.
Your site must be served over https. blogr.ai refuses to deliver to private or internal addresses.