30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

Update Advanced SEO Settings

seo/update-advanced-settings covers permalink and fallback-metadata settings: whether the category base is stripped from category URLs, the category and tag base slugs, the site-wide default SEO title and meta description used when a post sets none, and whether Yoast force-rewrites titles for themes that do not support title-tag.

Changing a base slug changes live URLs.

At a glance

Abilityseo/update-advanced-settings
ToolsetYoast SEO — toolset/yoast-seo
GroupYoast SEO › Settings
RequiresYoast SEO, active on the site
Capabilitymanage_options
SafetyWrites data
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

The URL changes are the dangerous half

Stripping the category base turns /category/guides/ into /guides/. Every category URL on the site changes, every inbound link to the old form breaks, and WordPress does not redirect them.

The same applies to changing a base slug. These are not settings changes in effect — they are site-wide URL migrations, and they need a permalink flush and redirects for the old paths.

Stripping the base also risks collisions: with the base removed, a category slug and a page slug can occupy the same URL, and which one wins is not something you choose.

The fallback title and description are the harmless half. They are used when a post sets nothing and its post type template produces nothing either, which is a narrow case and a useful safety net.

Force-rewriting titles is for themes that hard-code the title tag instead of supporting title-tag. It is a workaround, and on a modern theme it should be off — leaving it on can produce duplicated title tags.

Idempotent.

Input

NameTypeRequiredWhat it is
settingsobjectYesA map of setting key to new value. Keys outside this area are refused.

What comes back

NameTypeWhat it is
updatedarrayThe keys that changed.
settingsobjectThe area after the write.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent 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 a fallback meta description for posts with none.

It resolves to one call:

{
  "ability": "seo/update-advanced-settings",
  "parameters": {
    "settings": { "metadesc-home-wpseo": "What this site is about, in one sentence." }
  }
}

Worth knowing

  • Stripping the category base is a site-wide URL migration. Flush permalinks and redirect.
  • With the base stripped, category and page slugs can collide.
  • Force-rewriting titles is a workaround for old themes and can duplicate the title tag.
  • The fallback metadata is the safe part of this area.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading