seo/update-homepage-seo changes the SEO title and meta description templates used for the site front page.
They apply when the front page shows the latest posts. If a static page is the front page, its own per-page SEO wins and these are ignored.
At a glance
| Ability | seo/update-homepage-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
That conditional is the whole reason this page needs writing carefully. The write always succeeds — the templates are stored either way — and on a site with a static front page it has no visible effect whatsoever.
Which is indistinguishable from a broken write unless you know the rule. Check the front page configuration first, and if a static page is set, edit that page’s SEO with Yoast’s own post ability instead.
Yoast titles and descriptions are templates — patterns like %%title%% %%sep%% %%sitename%% expanded per page — rather than literal strings.
The front page template deserves more care than most. It is the title shown for the site’s most-linked URL, it is what appears when somebody searches for the organisation by name, and it is usually the last template anybody reviews.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
title | string | No | The SEO title template for the front page. |
description | string | No | The meta description template. |
What comes back
| Name | Type | What it is |
|---|---|---|
updated | array | Which templates 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:
Set the homepage SEO title.
It resolves to one call:
{
"ability": "seo/update-homepage-seo",
"parameters": {
"title": "%%sitename%% %%sep%% %%sitedesc%%"
}
}Worth knowing
- Ignored when a static page is the front page. The write still succeeds.
- Check the front page configuration before concluding the write failed.
- This is the title shown when somebody searches for the site by name.
- Idempotent.
Related abilities
- Get Home Page SEO — see which source is in play
- Update Title And Meta Templates — the rest of the templates
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category