rank-math/get-rendered-head fetches the complete <head> markup Rank Math actually outputs for a URL — template variables resolved, fallbacks applied, JSON-LD serialised.
It is how you verify a change rather than trusting what the settings say.
At a glance
| Ability | rank-math/get-rendered-head |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Content SEO |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Between the stored settings and the rendered head sits a whole layer of resolution: template variables expand, a missing per-post title falls back to the post-type template which falls back to a global default, filters from the theme and other plugins run, and the schema is assembled from several sources.
So reading the stored title tells you very little about the title that ships. A per-post override that looks set may be overridden by a filter; a global template that looks wrong may be fine because every post has its own.
This is the only read in the suite that answers the actual question — what does Google see?
It requires Rank Math’s headless support to be enabled, since that is the mechanism that exposes the rendered head. When it is not, the error names the setting rather than failing vaguely.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
url | string | Yes | The URL to render. |
What comes back
| Name | Type | What it is |
|---|---|---|
head | string | The complete rendered head markup. |
url | string | The URL rendered. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
What meta tags does Google actually see on our homepage?
It resolves to one call:
{
"ability": "rank-math/get-rendered-head",
"parameters": {
"url": "https://example.com/"
}
}Worth knowing
- The only read that reflects what is actually served.
- Needs Rank Math’s headless support enabled; the error names the setting.
- Use it after any settings or meta change, not before.
- Includes the serialised JSON-LD.
Related abilities
- Update Rank Math SEO Meta — the per-post layer
- Update Rank Math Title & Meta Settings — the template layer
- Get Rank Math Schema Status — the publisher entity in the JSON-LD
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category