What Connecting WordPress Does
Connecting your WordPress site lets Apex® publish the articles it writes straight to your blog. Each publish sends the title, content, slug, excerpt, categories, tags and featured image with its alt text, plus the SEO title, meta description and keyphrases to your SEO plugin. Every image in the article is added to your site's Media Library and served from your site.
The connection is in Preferences → Connections → Publishing Accounts → WordPress. Each workspace connects one WordPress site.
Before You Start
- A WordPress user with the Editor or Administrator role. Lower roles can connect but may only save drafts or pick existing categories.
- Your site on https. WordPress only allows application passwords over https.
- The WordPress REST API reachable. Some security plugins or firewalls block it, or turn application passwords off.
Step 1: Connect With an Application Password
An application password is a separate password WordPress creates for one app. Apex® never needs your normal password, and you can revoke the application password in WordPress at any time.
- In WordPress, open Users → Profile while signed in as an Editor or Administrator.
- Under Application Passwords, type "Apex®" and click Add New Application Password.
- Copy the password WordPress shows. It's only shown once.
- In Apex®, open Preferences → Connections and click Connect on the WordPress row.
- Enter your Site address (Apex® fills in your website from Preferences if you've added it), your Username and the Application password, then click Connect WordPress.
When it works, the row shows Connected, "Publishing to" your site, and "Signed in as" your user with their role. Use Change to connect with another user or site, or Disconnect to remove it.
Step 2: Field Mapping and Test Mapping
Right after connecting, Field Mapping shows where each article field lands in WordPress, grouped into Post, Search Results and Sharing & Discovery. Each field has a status: Ready, Limited, Needs SEO Bridge, Update SEO Bridge or Not Sent.
SEO fields go to picks the SEO plugin that receives the SEO title, meta description and keyphrases. Automatic uses the plugin Apex® found on your site. You can also choose Yoast SEO, Rank Math, SEOPress, All in One SEO or Don't send SEO fields.
Click Test Mapping to prove it on your real site. Apex® sends every field to a private test draft, reads each one back, then deletes the draft and its test image. Fields that worked show Landed; any that didn't show Didn't Land with the reason. Nothing is published, and you can run Test Again any time.
The Apex® SEO Bridge Plugin
Most SEO plugins don't accept their fields from other apps. The free Apex® SEO Bridge plugin fixes that: it writes the SEO title, meta description and keyphrases into Yoast SEO, Rank Math, SEOPress or All in One SEO's own fields and reads them back, so every publish is confirmed. It also adds Facebook and X sharing fields, merges the FAQ and article schema into your SEO plugin's schema, and pings search engines through IndexNow when you publish.
- In the Field Mapping card, click Download SEO Bridge.
- In WordPress, go to Plugins → Add New → Upload Plugin, choose the file and activate it. If an older version is installed, choose Replace current with uploaded.
- Back in Apex®, click Check Again. The badge changes to Up To Date.
Without the bridge, articles still publish with their title, content, images, categories and tags. SEO fields can only be sent to Rank Math, sharing fields and search engine pings aren't sent, and the FAQ schema goes inside the post only when your WordPress user is allowed to add it. If the card says Update Available, download the new version and replace the old one the same way.
How Publishing and Updating Works
- Publish To WordPress does in Preferences → Publishing sets the default: Save As Draft (it waits for you in WordPress) or Publish Live. You can also schedule an article for a later time.
- Content format sends Blocks (opens in the block editor) or Classic HTML.
- The categories and tags you set in the article editor are sent with the post, and tags that don't exist yet are created.
- Publishing the same article again updates the same post instead of creating a new one, and images already uploaded are reused.
- An interrupted publish is never posted twice.
For the article side of publishing, see Publish Articles to WordPress.
Troubleshooting
| Problem | What to do |
|---|---|
| "WordPress didn't accept the username or application password" | Create a new application password under Users → Profile → Application Passwords and connect again. |
| "Application passwords are turned off on this site" | A security plugin or your host turned them off. Turn them back on, or ask your host. They also need https. |
| "Couldn't find WordPress at" your address | Check the site address and that the REST API isn't blocked by a security plugin or firewall. |
| "This WordPress user can only save drafts" | Connect an Editor or Administrator, or send the article as a draft. |
| SEO fields show Needs SEO Bridge | Download and install the SEO Bridge from the card, then click Check Again. |
| Test Mapping shows Didn't Land for SEO fields | Make sure the chosen SEO plugin is active, update the SEO Bridge, then Test Again. |
| "WordPress sent back something unexpected" | A security plugin or firewall is probably blocking the REST API. Allow it for your site, then try again. |
More fixes are in Fix WordPress Publishing Problems.
Related Guides
Was this article helpful?




