seo/update-post-type-archive-seo changes the SEO title and meta description templates for one post type’s archive, and whether that archive is indexed.
It only applies to post types registered with has_archive.
At a glance
| Ability | seo/update-post-type-archive-seo |
| Toolset | Yoast SEO — toolset/yoast-seo |
| Group | Yoast SEO › Archives & System Pages |
| 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 archive is a page that exists whether or not anybody has thought about it, and its default title is generally the post type’s label followed by the site name — accurate and entirely uncompelling.
Since it is frequently the page that ranks for the category of thing the site sells or publishes, the template is worth writing deliberately.
The indexing toggle here is the archive’s own, separate from whether individual items of that type are indexed. An archive can be noindexed while its items are indexed, which is the right configuration when the archive adds nothing a visitor wants.
Yoast titles and descriptions are templates — patterns like %%title%% %%sep%% %%sitename%% expanded per page — rather than literal strings.
Writing for a type with no archive stores a template nothing uses. It is harmless and it is also not what you meant.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
post_type | string | Yes | The post type. |
title | string | No | The SEO title template for the archive. |
description | string | No | The meta description template. |
noindex | boolean | No | Whether the archive is excluded from search. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | Which settings changed. |
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 the products archive a proper SEO title.
It resolves to one call:
{
"ability": "seo/update-post-type-archive-seo",
"parameters": {
"post_type": "product",
"title": "All products %%sep%% %%sitename%%"
}
}Worth knowing
- The archive’s indexing is separate from its items’ indexing.
- Writing for a type with no archive stores a template nothing reads.
- Often the page that ranks for the whole category of content.
- Idempotent.
Related abilities
- Get Post Type Archive SEO — read it first
- Update Post Type SEO Settings — the items rather than the archive
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category