Skip to main content

Meta Description

Right under the title in a search result, there is usually a short block of text. That text is called the snippet, and it is your chance to tell a stranger, in a sentence or two, why your page is worth their time.

The <meta name="description"> tag is how you suggest what that snippet should say. It is small, and it is not magic, but a good one can make the difference between a click and a scroll-past.


What You Will Learn​

  • What the meta description is, and what it is not
  • How search engines choose the snippet
  • The right length, and what happens when it is too long
  • A simple formula for writing a good one
  • How to handle quotes, templates, and duplicates
  • How to control or limit snippets
  • How to audit a whole site

The Big Idea​

index.html
<head>
  <title>Rye Bread Recipe: Easy No-Knead Loaf | The Bread Bin</title>

  <!-- Missing: search engines pick their own snippet -->

  <!-- Weak: vague, and the same on every page -->
  <meta name="description" content="Welcome to our website.">

  <!-- Stuffed: keywords, not sentences -->
  <meta name="description" content="bread, rye bread, best bread, bread recipe, buy bread">

  <!-- Good: specific, honest, and written for people -->
  <meta name="description" content="Bake a crusty rye loaf at home with five simple ingredients. No kneading and no special tools. Get the step-by-step guide.">
</head>

Fill in the three parts, switch between desktop and mobile, and watch the preview and the tag.

What It Is, and What It Is Not​

It is a short summary of a page, written in plain text, that a search engine may use as the snippet under your title. It may also be used by some other tools, such as link previews in apps.

It is not:

  • A direct ranking factor. Google has said it does not use the description to rank pages. (Other search engines may differ, and details can change.) The real value is click-through: a clear, honest description helps more of the right people choose your result.
  • A guarantee. Search engines often show a different snippet.
  • A place for keywords. The old "meta keywords" tag is ignored by major search engines, and stuffing a description does not help.
  • A summary of the whole site. Write one for each page.
A description is an invitation

Think of it as a line on a shop window. It does not make the shop better. It helps the right person decide to walk in.

How Search Engines Choose the Snippet​

A search engine looks at your page and the search, and chooses the text that answers best. It might use your meta description, or it might take sentences from your page, or mix the two. Often it will use your description when it describes the page well, and take page text when the description does not match what was searched.

Try it. Type different searches, and see which text a simple simulation would pick:

http://127.0.0.1:5500/index.html


The page the snippet comes from:

  • Your meta description (matches 2 of 4 words): Bake a crusty rye loaf at home with five simple ingredients. No kneading and no special tools.
  • Paragraph 1 of the page (matches 2 of 4 words): Rye flour has less gluten than wheat flour, so a rye dough is stickier and does not need kneading. Mix it, rest it, and bake.
  • Paragraph 2 of the page (matches 1 of 4 words): You will need 500 g of rye flour, 350 ml of warm water, 7 g of salt, and 3 g of dried yeast. Keep a bowl of cold water nearby for your hands.
  • Paragraph 3 of the page (matches 1 of 4 words): Bake the loaf at 230 degrees for 15 minutes, then lower the heat to 200 degrees for another 30 minutes. Let it cool fully before slicing.

A snippet a search engine might show:

Rye Bread Recipe: Easy No-Knead Loaf | The Bread Bin
Bake a crusty rye loaf at home with five simple ingredients. No kneading and no special tools.

Chosen from: Your meta description.

This is a simulation with very simple rules. Real search engines use far more signals. The lesson it shows is real: if your description matches what people search for, it is likely to be used. If not, a search engine may pick text from the page, so your page text matters too.

Two lessons:

  1. Write a description that fits the page's main purpose. That is when it is most likely to be shown.
  2. Good page text matters too. Clear, well-organised paragraphs give a search engine good snippet material, whatever the description says.

How Long Should It Be?​

There is no official limit. Search engines cut text to fit the space, and the space is measured in pixels. As a rough guide:

  • Desktop: about 150 to 160 characters often fits.
  • Mobile: often shorter, around 120 characters.
  • Too short (under about 70 characters) wastes space you could use.

So put the most important words first, and keep the whole thing to one or two sentences. It is better to be clear and slightly long than short and vague. Do not worry about exact numbers.

A Simple Formula​

Most good descriptions answer three small questions:

  1. What is on the page? (the main promise)
  2. Why should I care? (a detail, a benefit, who it is for)
  3. What can I do next? (a gentle step, optional)
PageDescription
RecipeBake a crusty rye loaf at home with five simple ingredients. No kneading and no special tools.
ProductA solid beech bread bin with a bamboo lid. Keeps loaves fresh for up to five days. Free returns for 30 days.
GuideNot sure which bread knife to buy? We tested eight and explain when a serrated blade beats a straight one.
HomeEasy, tested bread recipes for beginners, with clear steps, honest tips, and no fancy equipment.

(Claims such as "free returns" must be true. See the notes below.)

Writing tips​

  • Use plain, active language. Write like you are speaking to one person.
  • Include the words people search for, naturally. A search engine often bolds matching words in the snippet, which draws the eye.
  • Be specific. Numbers, names, and details beat "great," "best," and "ultimate."
  • Be honest. Say what the page really offers.
  • Do not repeat the title. Add something new.
  • Finish your sentences. A cut-off sentence looks unfinished, but a full one cut at the end still reads well.
  • Avoid hype and shouting.

Quotes, Characters, and Templates​

  • A double quote can break the tag. Inside content="...", a " ends the value too early. Use &quot;, or use single quotes in the text.
  • Write &amp; for an ampersand, when you write it by hand.
  • Use plain text only. HTML tags are not understood, and are shown as text or ignored.
  • One description tag per page. If there are several, search engines may use only one.
  • Avoid line breaks inside the value.
  • Check the output of your templates. In a CMS or framework, a description is often filled in from a field. Make sure it is not empty, and not the same for every page.
<!-- Breaks: the quote ends the value early -->
<meta name="description" content="Our "famous" rye loaf.">

<!-- Fixed -->
<meta name="description" content="Our &quot;famous&quot; rye loaf.">
<meta name="description" content="Our famous rye loaf.">

Unique, Not Copied​

Every page should have its own description. The same one on many pages tells search engines (and people) nothing about what makes each page different.

  • No description is better than a copied one. A search engine can then choose a snippet from the page.
  • For large sites, write descriptions by hand for your most important pages. For the rest, a template that fills in details (such as a product's name and price) can work, as long as the results read naturally.
  • Do not auto-generate nonsense. Descriptions that are cut-and-pasted from the page's first lines often read badly.

Controlling Snippets​

Sometimes you want to limit what search engines show. A few options exist, and they vary by search engine, so check each one's documentation:

  • nosnippet in the robots meta tag asks that no text snippet be shown. Use it rarely, since it can lower your click-through.
  • max-snippet:N limits the snippet to N characters.
  • data-nosnippet is an attribute you can put on parts of a page to ask Google not to use that text in snippets.

These are covered further in Robots Meta.

Description, Social, and Accessibility​

  • og:description is the description used when your link is shared in social apps. It can be written separately, and can be warmer or shorter. See Open Graph.
  • aria-describedby and similar attributes describe controls on a page for screen readers. They are different things. See aria-describedby.
  • Do not hide important information in the description. It should repeat, not replace, what is on the page.

Descriptions in Docusaurus​

In Docusaurus, set a description in each page's frontmatter, and it becomes the meta description. Every page in this course has one. Write each one by hand, and keep them unique. Docusaurus also lets you set a site-wide default, but a page-specific one is always better. Check the current Docusaurus documentation for the exact options.

Audit a Whole Site​

A common problem is not a bad description but a missing or copied one. Paste your own pages below, or use the sample:

http://127.0.0.1:5500/index.html


6 pages checked. 5 with something to improve.

  • / (96 characters) OK
  • /recipes/rye-bread (94 characters) Improve: Used on 2 pages. Write a different one for each page.
  • /recipes/sourdough (94 characters) Improve: Used on 2 pages. Write a different one for each page.
  • /recipes/bagels (63 characters) Improve: Quite short (63 characters). You have room to say more. The word "bagels" appears 6 times. That looks like keyword stuffing. Does not end like a sentence. Finish it with a full stop.
  • /about Improve: The description is empty.
  • /blog/baking-tips (6 characters) Improve: Quite short (6 characters). You have room to say more.

The audit runs in your browser. Nothing is sent anywhere. It cannot tell whether a description is accurate, or matches what the page really says.

To find real descriptions on a site, use a crawler tool, Search Console, or "view source" on key pages.

Good Habits​

  • Write one for every important page, by hand.
  • Make each unique, specific, and true.
  • Use one or two clear sentences, roughly 70 to 160 characters.
  • Put the key points first.
  • Use natural wording, including the words people search for.
  • Escape quotes and ampersands.
  • Check what search engines actually show, and improve weak snippets.
  • Do not rely on it for ranking. Think of it as a click-winner.

Meta Description Checklist​

  • The page has exactly one meta description
  • It is unique to this page
  • It says what the page offers, in plain words
  • It is roughly 70 to 160 characters, with key points first
  • It does not just repeat the title
  • It has no hype, no stuffing, and no false claims
  • Quotes and ampersands are escaped
  • It is plain text, with no HTML
  • Translated pages have descriptions in their own language
  • It does not contain private data

Security and Privacy Notes​

  • Do not put private data in descriptions. Descriptions are public. Names, emails, prices only for members, and anything private can appear in search results, caches, and shared links.
  • Be careful with user-generated descriptions. If a description is filled from user input (a profile, a listing), escape it, and never build the tag from raw input. A stray quote could break your HTML, or inject unwanted content.
  • No false claims. Promises like "free," "official," "certified," or "guaranteed" must be true. False claims can harm people, and may break advertising rules. This is not legal advice.
  • Do not impersonate other brands or copy their wording to draw clicks.
  • Old descriptions can linger. Search engines cache snippets. If a page has been removed or changed, an old snippet may still show for a while.
  • Spam and injection. If your site has been hacked, attackers sometimes insert spam into descriptions. Check what shows in search results for your site, from time to time.

Global Audience Notes​

  • Write the description in the language of the page. And set lang to match. See International SEO.
  • Translate the meaning, not word for word, and use the terms local readers search for.
  • Lengths differ by script. Chinese, Japanese, and Korean characters are wide, so descriptions are usually shorter in characters. Test how they look.
  • Use UTF-8, so accents and non-Latin scripts display correctly.
  • Right-to-left languages such as Arabic and Hebrew need correct direction in previews. Check them.
  • Currencies, dates, and units should match the region.
  • Avoid idioms and humour that do not translate well.

Common Mistakes to Avoid​

  1. No description at all, on important pages.
  2. The same description on every page.
  3. Keyword stuffing, or lists of keywords.
  4. Repeating the title.
  5. Hype and false promises.
  6. A description that does not match the page.
  7. Unescaped quotes that break the tag.
  8. HTML tags inside the description.
  9. Too long, with the important words at the end.
  10. Too short and vague, such as "Welcome."
  11. Treating it as a ranking trick.
  12. Never checking what search engines really show.

Practice Time​

Try these in your browser and your editor:

  1. Use the description writer. Make a good one, and then make a bad one on purpose. What does the checker say?
  2. Switch between desktop and mobile. What gets cut?
  3. Use the snippet chooser with five different searches. When is your description used?
  4. Write descriptions for a recipe, a product, a guide, and a home page.
  5. Paste five pages from a site you built into the audit. Fix every problem.
  6. Add a double quote to a description by hand, and check the tag in the output. How do you fix it?
  7. Search for something you know well. Compare each result's snippet. Which ones make you want to click?
  8. Find a result where the snippet looks like it came from the page, not the description. Why?
  9. Open Search Console, and find a page with many impressions and few clicks. Rewrite its description.
  10. Bonus: write two different descriptions for one page, and compare their click-through rates over a month.

Quick Recap​

Click a question to check your answer.

1. What is a meta description?

A short, plain-text summary of a page, in a &lt;meta name="description"&gt; tag, that search engines may use as the snippet under your title.

2. Is it a ranking factor?

Google has said it does not use it for ranking. Its value is in winning clicks, by helping the right people choose your result.

3. Will a search engine always show your description?

No. It may choose text from the page instead, especially when your description does not match what was searched.

4. How long should it be?

Roughly 70 to 160 characters, with the key points first. Desktop shows more than mobile, and cut-offs depend on pixel width.

5. How can a quote break your description tag?

A double quote inside content="..." ends the value early. Write &quot;, or avoid the quote.

6. What is the problem with copying one description to many pages?

It does not tell people or search engines what makes each page different. Write a unique one for each page, or leave it out and let the search engine choose.

Key Takeaways​

  • A meta description is a short, honest pitch for one page.
  • It is not a ranking factor, but a good one wins clicks.
  • Search engines may rewrite it, so match it to the page.
  • Aim for roughly 70 to 160 characters, and put the key points first.
  • Use the formula: what, why you should care, and what next.
  • Make each unique, and escape quotes.
  • No stuffing, hype, or false claims.
  • Audit your site, and check what search engines show.

Next, learn how headings help both readers and search engines understand your page, in Headings and SEO.