Using Hatch with Yoast and Rank Math

By the end of this guide you will know which SEO plugins Hatch Connect reads, how your titles, descriptions and social settings reach your Astro frontend on Cloudflare Workers, and how to check that the data is flowing.

Which SEO plugins Hatch reads

Hatch Connect has an SEO bridge that detects Rank Math or Yoast SEO and passes the head data you already set in that plugin to the frontend. Premium editions (Yoast SEO Premium, Rank Math Pro) are detected too, and their data flows the same way as the free versions.

• Rank Math: Hatch calls Rank Math’s own getHead endpoint for the URL.
• Yoast SEO: Hatch calls Yoast’s get_head endpoint. Yoast also adds yoast_head_json to posts in the REST API, and the frontend can read either path.
• No SEO plugin: Hatch builds a minimal head itself, and the frontend uses your post title and excerpt.

All in One SEO (AIOSEO): the current Hatch code has no AIOSEO detector or bridge. If AIOSEO is your only SEO plugin, Hatch treats the site as having no SEO plugin and falls back to the minimal head. To carry your SEO settings over, use Rank Math or Yoast SEO.

When more than one SEO plugin is active

Hatch picks one provider. Rank Math wins over Yoast when both are active. To keep things simple, run only one SEO plugin.

How SEO data reaches the frontend

Hatch exposes the data under the hatch/v1 REST address:

• /wp-json/hatch/v1/seo-head?url=... returns the rendered head HTML for a URL (requires a signed-in account).
• /wp-json/hatch/v1/schema?url=... returns the JSON-LD for a URL (requires a signed-in account).
• A hatch_seo field is added to post data in the REST API.
• The public /wp-json/hatch/v1/features response includes an integrations.seo block showing which plugin was detected.

Your frontend fetches these when it builds or renders pages, so you keep editing SEO in WordPress exactly as before.

Set it up

1. Install and activate Rank Math or Yoast SEO in WordPress, if you have not already.
2. Fill in titles, meta descriptions and social settings in that plugin as usual.
3. In wp-admin, open Hatch and go to the Plugins tab.
4. Check that your SEO plugin shows as detected.
5. Deploy or redeploy your frontend so pages pick up the data.

Check the data is flowing

1. Open https://your-site.com/wp-json/hatch/v1/features in a browser.
2. Find integrations and then seo. The detected entry should name your plugin.
3. Open a post on your frontend, view the page source and confirm the title and description match what you set in the SEO plugin.

If the REST address returns 404, see WordPress REST API 404 and permalinks.

Detection is not the same as data

A green check on the Plugins tab means Hatch sees the plugin. It does not mean every post has SEO data. Posts you have not filled in fall back to the plugin’s own defaults.

What to do next

• Add the AI answer layer with RankReady
• How the hatch/v1 REST bridge works
• Hatch endpoints reference
• Check Hatch Connect is working