Skip to content

Connect Your WordPress Site

Connect WordPress with an application password, check Field Mapping, install the Apex® SEO Bridge and see how publishing and updating articles works.

5 min readUpdated 19 October 2026

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.

  1. In WordPress, open Users → Profile while signed in as an Editor or Administrator.
  2. Under Application Passwords, type "Apex®" and click Add New Application Password.
  3. Copy the password WordPress shows. It's only shown once.
  4. In Apex®, open Preferences → Connections and click Connect on the WordPress row.
  5. 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.

  1. In the Field Mapping card, click Download SEO Bridge.
  2. 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.
  3. 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

ProblemWhat 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 addressCheck 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 BridgeDownload and install the SEO Bridge from the card, then click Check Again.
Test Mapping shows Didn't Land for SEO fieldsMake 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.

Was this article helpful?

FAQs

Questions, Answered

Can’t find what you’re looking for? Our team is happy to help.

Does Apex® need my WordPress password?

No. You create an application password in WordPress under Users → Profile, and Apex® uses that. You can revoke it at any time without changing your real password.

Which WordPress role should I connect with?

An Editor or Administrator. Lower roles can connect, but they may only be able to save drafts or use existing categories.

Why does WordPress reject my application password?

Usually it was mistyped, revoked, or application passwords are turned off by a security plugin or host. Create a new one and check your site is on https.

What is the Apex® SEO Bridge?

A free WordPress plugin you download from the WordPress card. It writes the SEO title, meta description and keyphrases into your SEO plugin, reads them back to confirm, and adds sharing fields and schema.

Which SEO plugins does Apex® support?

Yoast SEO, Rank Math, SEOPress and All in One SEO, through the Apex® SEO Bridge. Without the bridge, only Rank Math can receive SEO fields.

What happens if I don't install the SEO Bridge?

Articles still publish with their title, content, images, categories and tags. SEO fields reach only Rank Math, and sharing fields and search engine pings aren't sent.

What does Test Mapping do?

It sends every field to a private test draft on your site, checks where each landed, then deletes the draft and its test image. Nothing is published.

Does publishing an article twice create a duplicate post?

No. Publishing again updates the same WordPress post and reuses its images, and an interrupted publish is never posted twice.

Can Apex® save articles as drafts in WordPress?

Yes. Set Publish To WordPress does to Save As Draft in Preferences → Publishing, and articles wait for you in WordPress.

Does Apex® upload images to my Media Library?

Yes. The featured image and every image in the article are added to your Media Library with their alt text and served from your site.

Can I choose blocks or classic HTML?

Yes. Content format in Preferences → Publishing sends Gutenberg blocks or classic HTML.