rank-math/update-title-settings writes Rank Math title and meta settings: the global template layer that applies to every object of a type.
This is not where a single post’s title override lives. That is rank-math/update-seo-meta.
At a glance
| Ability | rank-math/update-title-settings |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Settings |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Not idempotent — each call changes the row set, so re-running is not a no-op |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
Template layer, not post layer
Rank Math resolves a page’s title through a chain: the post’s own override, then the post type’s template, then a global default. This ability writes the middle and bottom of that chain.
Which means a change here can appear to do nothing. A post type whose posts all have individual overrides will not change at all when its template does — the template is only consulted when the override is empty.
That is worth knowing before concluding the write failed. rank-math/get-rendered-head shows what actually resolves for a given URL.
The scope parameter is how you name what you are writing: scope=post-type or scope=taxonomy with an object naming it, and separate scopes for the homepage, author and date archives, the global defaults, social profiles and Local SEO.
Social profiles and Local SEO are here because they feed the publisher entity in the structured data, which rank-math/get-schema-status reports. Editing the social profile list changes the sameAs array on every page of the site.
Submitting a field that does not belong to the panel rejects the whole write, so rank-math/get-settings comes first: it lists the field IDs the panel accepts, with their types, allowed values and bounds.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
scope | string | Yes | What to write: post-type, taxonomy, homepage, social, local-seo and the archive scopes. |
object | string | Required for post-type and taxonomy scopes | Which post type or taxonomy. |
settings | object | Yes | A map of field ID to value. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | The fields that changed. |
settings | object | The scope after the write. |
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:
Set the default SEO title template for products.
It resolves to one call:
{
"ability": "rank-math/update-title-settings",
"parameters": {
"scope": "post-type",
"object": "product",
"settings": { "pt_product_title": "%title% | %sitename%" }
}
}Worth knowing
- Templates are only used where a post has no override of its own.
- A change here can correctly appear to do nothing. Verify with the rendered head.
- Social profiles feed the
sameAsarray on every page. - Local SEO settings feed the publisher entity in the structured data.
Related abilities
- Get Rank Math Settings — discover the field IDs
- Update Rank Math SEO Meta — the per-post layer above this
- Get Rank Math Schema Status — what the social and local fields build
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category