seo/update-taxonomy-seo changes the Yoast settings for one taxonomy.
It affects every term in it. To change a single term, taxonomies/update-term-seo is the ability.
At a glance
| Ability | seo/update-taxonomy-seo |
| Toolset | Yoast SEO — toolset/yoast-seo |
| Group | Yoast SEO › Content Types |
| Requires | Yoast SEO, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
The reach is the thing to hold on to. Changing a taxonomy’s title template changes the title of every term archive that does not have its own — which on most sites is all of them, so one write changes dozens or hundreds of pages.
That is usually the intent and occasionally a surprise. Checking a couple of real term archives afterwards with seo/get-indexable confirms the expansion looks the way you expected.
Noindexing a taxonomy removes every one of its term archives from search and from the sitemap. For an internal taxonomy that is correct; for categories on a blog it removes a large set of genuinely useful landing pages.
Keys include the taxonomy as a suffix, so read seo/get-taxonomy-seo for the exact names.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
taxonomy | string | Yes | The taxonomy. |
settings | object | Yes | A map of key to value. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | The keys that changed. |
settings | object | The area 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:
Give category archives a proper title template.
It resolves to one call:
{
"ability": "seo/update-taxonomy-seo",
"parameters": {
"taxonomy": "category",
"settings": { "title-tax-category": "%%term_title%% archives %%sep%% %%sitename%%" }
}
}Worth knowing
- One write changes every term archive without an override.
- Noindexing a taxonomy removes all its term archives from search and the sitemap.
- Keys include the taxonomy as a suffix.
- Idempotent.
Related abilities
- Get Taxonomy SEO Settings — get the exact key names
- Update Term SEO — one term instead of all of them
- Get Indexable SEO — check a real term archive afterwards
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category