Docs · Getting connected
Connect WordPress
Publish drafts, scheduled posts, or live pages through the WordPress REST API, with an export fallback if direct publishing is unsafe.
What the connection does
The WordPress connector publishes through the REST API using an application password. It supports draft, scheduled, and live states, and carries media, metadata, tags, and standard post fields.
WordPress is part of the launch connector set alongside Webflow, Shopify, Ghost, and a generic webhook for everything else. If direct publishing is not appropriate for your setup, the fallback is an HTML or Markdown export you can paste in yourself.
Set it up
- In WordPress, create a dedicated user for SearchHandled with the Author or Editor role, never an admin account you use personally.
- Generate an application password for that user under Users → Profile → Application Passwords. WordPress 5.6 or newer is required.
- In SearchHandled, open Settings → Integrations → WordPress and enter your site URL, the username, and the application password.
- SearchHandled runs a preflight check: REST API reachable, slug conflicts, media upload permission, and a test draft that is created and then removed.
- Choose your publish mode (draft-only, mixed, or auto-publish for low-risk work) and save.
Troubleshooting
If the preflight fails, the most common causes are a security plugin blocking the REST API or application passwords, a permalink setting that changes the API path, or a host that strips the Authorization header. The connection detail page shows which check failed and the raw response.
Completed publishes are recorded with their destination identity. WordPress also keeps its own revision history; confirm that your site's retention policy meets your recovery needs before enabling live publishing.
Getting connected
See it working on your own site.
Get an illustrative Growth Map, then follow these guides to connect the real data.