Website Spec
← Foundations
Recommended

<meta name=\"description\">

A short, unique summary of the page used by search engines and social platforms as a snippet. Google may rewrite it, but a good one is rewritten less often.

What it is

A meta description is a short summary of the page, declared in <head>:

<meta name="description" content="The Website Specification is a platform-agnostic spec of what a good website must do, from doctype to security headers." />

The browser does not render it. It is metadata for crawlers, social platforms, and AI agents that fetch the page.

Why it matters

The meta description does not directly affect search ranking, but it strongly affects whether the user clicks. Search engines often use it as the snippet shown beneath the title in results:

Social platforms (Slack, Discord, iMessage, LinkedIn) use it as the preview text when no Open Graph description is set. AI agents and answer engines use it as a short canonical summary.

A description that is missing, duplicated across pages, or stuffed with keywords is a wasted asset on every result and every share.

How to implement

Write one description per page, specific to that page:

<!-- Good -->
<meta name="description" content="The lang attribute on <html> tells screen readers, browsers, and search engines what language the page is written in. Use a valid BCP 47 tag." />

<!-- Bad: too long, generic, no useful information -->
<meta name="description" content="Welcome to our website. We are the best in the industry, providing world-class solutions for all your needs. Contact us today to learn more about what we do and how we can help your business grow in 2026." />

For the homepage, summarise the site as a whole. For article pages, summarise the article. For category or archive pages, describe what is in the category. Do not leave the description empty and do not auto-generate it from the first 160 characters of the body — that almost always picks up navigation or boilerplate.

If the page also sets <meta property="og:description">, write each separately. Social platforms prefer the OG version; search engines prefer the plain meta description. They can be similar but rarely identical, because the audience and the truncation length differ.

Common mistakes

Verification

Sources