set_meta_description: Agent-Applied Meta Description Changes

set_meta_description is the tool the Get AI Traffic agent uses to write a page’s meta description after you approve a fix. It sets the description your page hands search engines as its own summary, then publishes it through your site’s connection.

This page documents what the tool touches, what it refuses to touch, and how to undo it. For the decision of whether a given page needs a description at all, read Meta Description Length Won’t Save a Page With No Description at All. That question is a judgment call. This page is about the mechanics.

What it does

When you approve a missing_meta_description action item, the agent writes a short summary of the page and sets it as the meta description. On WordPress the tool routes to whichever plugin owns your metadata: if Yoast owns it, the value is written to Yoast’s _yoast_wpseo_metadesc field; otherwise the Get AI Traffic plugin stores and emits the tag itself. That routing starts from the site’s platform configuration, but the plugin gets the final say: it checks whether Yoast is actually running and uses Yoast’s field when it is, whatever the stored configuration says. So the description lands in the field your theme actually renders, even if the configuration is stale, instead of a second competing tag.

The tool enforces a hard length limit of 155 characters. If the description is longer than that, the tool rejects it and writes nothing: no ledger entry, no change to the page. So a value that lands is a value short enough that the search snippet will not truncate it.

What it will not touch

• The visible page. This tool writes head metadata only. Your body content, headings, and layout are left alone.
• Descriptions that do not fit. An over-length description is refused outright rather than silently trimmed. Nothing is recorded and nothing is published until the value fits.
• Other head fields. It sets the meta description and only the meta description. The Open Graph description, the title tag, and the canonical are separate fields set by separate tools.

Timing

The new description is written to your site immediately, but search engines only see it on their next crawl, and they rewrite descriptions often regardless. Expect the snippet you supplied to start showing up over the following crawls, not the same afternoon, and expect the engine to sometimes show its own version anyway.

Rolling back

Every applied change is written to the ledger with the prior description. roll_back restores the previous value exactly, whether that was an older description or an empty field.

Related tools

• purge_cache runs after an apply, so a cached copy of the old page does not keep serving the old description at the edge.
• set_social_meta sets the Open Graph description, which is a different field. The meta description is the search-snippet summary; og:description is the summary shown when the page is shared. Setting one does not set the other.

Findings this tool resolves

• missing_meta_description: a page has no meta description, so search engines scrape a fragment off the page instead.