Yoast meta description: set the template once and the per page field becomes the exception, not the chore

Almost everybody uses Yoast's meta description field the slow way: open a post, type a description, repeat four hundred times, give up around post sixty. The plugin is not built for that. It fills the description from a template set per content type, and the field on an individual post is an override for the pages that deserve one. So the correct order of work is template first, overrides second, and bulk sweep third. Get that order right and a site with hundreds of posts has a usable description on every one of them in an afternoon, with handwritten descriptions on the twenty pages that actually earn the effort.

This page is the mechanics: where the two places are, the variables with their exact syntax, the page types people miss, and how to diagnose a description that does not appear. For the writing itself, the length that survives and why Google rewrites descriptions whatever you do, see meta descriptions.

The two places a description comes from

	The template	The per page field
Where it is set	In Yoast's search appearance settings, on a tab per content type and per taxonomy	In the Yoast panel on the post, page or term itself
What it covers	Every item of that type, including ones published in future	One URL
What it is for	Making sure nothing ships with an empty description	The pages where a handwritten line is worth the time: the homepage, the money pages, the top twenty posts
If left alone	Yoast ships default templates you can modify	The template for that content type fills the gap. With no template, the search engine writes its own snippet from the page

The variables, with the syntax that actually works

Variables are wrapped in double percent signs and are replaced when the page renders. These are the ones Yoast documents for titles and descriptions, in its own words.

• %%sitename%%, the site's title from the Settings then General page.
• %%title%%, replaced with the title of the post or page.
• %%excerpt%%, replaced with the post or page excerpt, or auto generated if it does not exist. This is the single most useful variable in a description template, because it degrades gracefully: a post with a hand written excerpt gets that, and a post without one still gets sensible text.
• %%sep%%, the separator defined in your theme.
• %%category%%, the post categories, comma separated, and %%primary_category%% for the primary one only. Use the primary form in a description; a comma separated list of five categories reads like a tag cloud.
• %%date%%, the date of the post or page.
• %%term_title%%, the term name, and %%archive_title%%, the normal title WordPress generates for an archive. These two are what fix category and tag pages.
• %%page%%, the current page number with context, such as page 2 of 4. Yoast files this under advanced variables, and its own guidance is worth repeating: if you are unsure how to use the advanced variables, do not use them.

Yoast applies these templates automatically to the homepage, post types, taxonomies, products, collections and other pages, and ships defaults you can change.

Templates worth copying

• Blog posts: %%excerpt%% on its own. Then write real excerpts for the posts that matter, which improves the description and the archive listing at the same time.
• Category and tag archives: %%term_title%% followed by a clause you write by hand describing what that archive collects. Archives are where most WordPress sites have no description at all, because the person setting Yoast up only looked at the Posts tab.
• Products: a short handwritten frame around the product name, with the thing a buyer needs to know in the first eight words: what it is, the variant, and the one differentiator. Never the price, because the description will outlive it.
• The homepage: by hand, always. It is the one description on the site that is worth twenty minutes on its own.

Doing the back catalogue without opening four hundred posts

Yoast includes a Bulk Editor, which it describes as a way to see titles, meta descriptions and focus keyphrases for every page on your site in one view, with the ability to search for missing metadata and fix it in bulk. Yoast says it is built into Yoast SEO and included in the base plugin as well as in Premium, WooCommerce SEO and its AI product, with AI drafted metadata requiring a paid plan and nothing saving until you approve it. Its own help centre has the article explaining where to find the screen in your version, which is the right place to look because admin menus move between releases.

The order that wastes the least time: set the templates, let them fill everything, then use the bulk view to find the pages where the template output reads badly, and hand write only those. Working the other way round means writing descriptions for pages that get no traffic.

Three reasons a description you typed does not appear

• Two plugins are writing the tag. View the page source and count the description tags. If a theme has its own SEO options, or a second SEO plugin is still active, you can end up with two description tags and no control over which one is read. Switch one of them off rather than trying to make them agree.
• Caching. A page cache, a plugin cache or a CDN will keep serving the old head for as long as its rules say. Clear the cache and re-check the source, not the preview.
• You are on the wrong tab. A description typed on a post does nothing for the category archive that lists it, and a template set for Posts does nothing for a custom post type. If a whole class of URLs has no description, it is almost always a tab you have not opened.

A fourth, which is not a fault: your description is present and correct and the search result shows something else. Search engines rewrite descriptions when they judge a different sentence answers the query better, which is normal and is covered on the meta descriptions page linked above. The useful response is to check that the first words of your description match what the page is actually about, because a rewrite is often a signal of a mismatch rather than a bug.

Yoast meta description: the questions that come up

How long should it be in Yoast?

Yoast shows a progress indicator for description length as you type, and the useful target is a line that completes its own sentence well inside the limit, because results are truncated by pixel width rather than by a character count. Write the important clause first and the length question answers itself.

Where is the meta description field in Yoast?

Two places. In the Yoast panel on the individual post, page or term, for that one URL. And in Yoast's search appearance settings, on a tab for each content type and taxonomy, for the template that covers all of them.

Does the meta description affect rankings?

It is not a ranking factor in itself. It is the sales line in the result, which affects whether somebody clicks, and it is worth thirty seconds per important page for that reason alone.

What happens if I leave it blank?

The template for that content type fills it. If there is no template, the search engine writes its own snippet from the page content. A blank field is therefore a decision to let a machine choose, which is a reasonable choice on a thin archive page and a poor one on a page you want to sell something from.

Can I use the focus keyphrase inside the description?

Yes, and the reason to do it is that query terms get emboldened in the result, which makes the line easier to scan. Write the sentence for a person first and check that the phrase appears naturally, rather than fitting the sentence around the phrase. What each Yoast check is testing, and which ones to act on, is set out in Yoast content analysis.

Do the variables work in the per page field as well as the template?

They are designed for templates, which is where they earn their keep. On a single page you are usually writing a specific line anyway, so there is nothing for a variable to save you.

The description a machine writes when yours is not in reach

A meta description is a sentence you get to write about your own page, which makes it one of the few summaries of your business that you fully control. The other summaries are now written for you. An assistant asked about your company produces a sentence of its own, assembled from whatever it could retrieve, and that sentence is doing the job your description does in a search result: deciding whether somebody goes further. Checking what that sentence currently says about you takes a few minutes and tends to be the first time anybody in a company reads their own positioning written by something that was not trying to flatter them. AI Knows Us asks those questions across the main assistants and reports what comes back and what it was built from.