Jump to content

Wikipedia:Short description

From Wikipedia

Wikipedia:Short description

Template:Templatedata header

Template:Templatedata footer

Usage

[edit]

This template is used to define a short description for the current page. The description is typically:

  • brief – usually fewer than 40 characters;
  • neutral and descriptive;
  • supplementary to the article title, not simply a repeat of it.

Short descriptions are mainly consumed by tools and skins (for example, mobile views and search interfaces) and are not always shown in the normal desktop view.

Basic usage

[edit]

To add a short description to a page:

{{Short description|Encyclopedia of free educational textbooks}}

This stores the description Encyclopedia of free educational textbooks for the current page.

Preventing replacement

[edit]

If a description is already supplied (for example, from a higher level template) and you want to make sure that a local call does not overwrite it, use the noreplace parameter:

{{Short description|Free-content textbook project|noreplace=yes}}

In this case, if a short description has already been set elsewhere on the page, this call will be ignored.

Specifying a page type

[edit]

You may optionally supply a page type. This can be helpful for tools that group or filter pages:

{{Short description|Open-content textbook collection|pagetype=project}}

or

{{Short description|Polynomial invariant measuring multiple roots|pagetype=mathematics}}

Notes

[edit]
  • The short description should normally be in sentence case, without a final period:
 
Correct: Online free-content textbook collection Avoid: online FREE-CONTENT TEXTBOOK COLLECTION.
  • Avoid adding links, HTML tags or wikicode. The value is intended to be plain text.
  • Do not add maintenance notes, talk-page comments or other discussion content to the short description.

See also

[edit]

The short description of a Wikipedia article is a brief phrase, with a specific format, designed to work together with the title to indicate the article's scope and content.[1] It is a form of metadata that appears in search results, mobile displays, and other locations where space is limited.[2]

Purpose

[edit]

Short descriptions serve multiple functions within Wikipedia's ecosystem. They provide quick context for readers browsing search results, help disambiguate articles with similar titles, and improve the user experience on mobile devices where screen space is limited.[3] The descriptions are particularly useful when multiple articles share similar names, allowing users to quickly identify the correct article they're seeking.

Short descriptions are displayed in various locations including Google search results, Wikipedia's mobile interface, and link previews on social media platforms.[4] This makes them an important tool for helping readers find and identify Wikipedia content across different platforms and contexts.

Format and guidelines

[edit]

Length and style

[edit]

Short descriptions should be limited to approximately 40 characters, though this is a guideline rather than a strict limit.[1] The description should be a brief noun phrase that complements the article title. It should not be a complete sentence and should not include the article title itself.[2]

For biographical articles, the format typically follows the pattern of profession, nationality, and time period. For example, the short description for a footballer would be "Burundian footballer".[1] The description should answer the implicit question "What is this?" or "Who is this?" in the most concise way possible.

Content requirements

[edit]

Short descriptions should be:

  • Concise: Use the minimum number of words necessary to convey the essential information.[3]
  • Neutral: Maintain Wikipedia's neutral point of view, avoiding promotional or biased language.[4]
  • Accurate: Reflect the actual content and scope of the article.[1]
  • Complementary: Work together with the article title to provide context, not repeat it.[2]

Implementation

[edit]

Template usage

[edit]

Short descriptions are added to articles using the {{Short description}} template, which should be placed near the top of the article's wikitext.[1] The basic syntax is:

Template:Templatedata header

Template:Templatedata footer

Usage

This template is used to define a short description for the current page. The description is typically:

  • brief – usually fewer than 40 characters;
  • neutral and descriptive;
  • supplementary to the article title, not simply a repeat of it.

Short descriptions are mainly consumed by tools and skins (for example, mobile views and search interfaces) and are not always shown in the normal desktop view.

Basic usage

To add a short description to a page:

{{Short description|Encyclopedia of free educational textbooks}}

This stores the description Encyclopedia of free educational textbooks for the current page.

Preventing replacement

If a description is already supplied (for example, from a higher level template) and you want to make sure that a local call does not overwrite it, use the noreplace parameter:

{{Short description|Free-content textbook project|noreplace=yes}}

In this case, if a short description has already been set elsewhere on the page, this call will be ignored.

Specifying a page type

You may optionally supply a page type. This can be helpful for tools that group or filter pages:

{{Short description|Open-content textbook collection|pagetype=project}}

or

{{Short description|Polynomial invariant measuring multiple roots|pagetype=mathematics}}

Notes

  • The short description should normally be in sentence case, without a final period:
 
Correct: Online free-content textbook collection Avoid: online FREE-CONTENT TEXTBOOK COLLECTION.
  • Avoid adding links, HTML tags or wikicode. The value is intended to be plain text.
  • Do not add maintenance notes, talk-page comments or other discussion content to the short description.

See also

For articles that should not have a short description, editors can use:

Template:Templatedata header

Template:Templatedata footer

Usage

This template is used to define a short description for the current page. The description is typically:

  • brief – usually fewer than 40 characters;
  • neutral and descriptive;
  • supplementary to the article title, not simply a repeat of it.

Short descriptions are mainly consumed by tools and skins (for example, mobile views and search interfaces) and are not always shown in the normal desktop view.

Basic usage

To add a short description to a page:

{{Short description|Encyclopedia of free educational textbooks}}

This stores the description Encyclopedia of free educational textbooks for the current page.

Preventing replacement

If a description is already supplied (for example, from a higher level template) and you want to make sure that a local call does not overwrite it, use the noreplace parameter:

{{Short description|Free-content textbook project|noreplace=yes}}

In this case, if a short description has already been set elsewhere on the page, this call will be ignored.

Specifying a page type

You may optionally supply a page type. This can be helpful for tools that group or filter pages:

{{Short description|Open-content textbook collection|pagetype=project}}

or

{{Short description|Polynomial invariant measuring multiple roots|pagetype=mathematics}}

Notes

  • The short description should normally be in sentence case, without a final period:
 
Correct: Online free-content textbook collection Avoid: online FREE-CONTENT TEXTBOOK COLLECTION.
  • Avoid adding links, HTML tags or wikicode. The value is intended to be plain text.
  • Do not add maintenance notes, talk-page comments or other discussion content to the short description.

See also

This explicitly indicates that the article should not have a short description, which is different from simply not having the template at all.[3]

WikiProject efforts

[edit]

The WikiProject Short descriptions is an organized effort to populate all Wikipedia mainspace articles with suitable short descriptions and to improve existing descriptions.[2] This project coordinates editors' efforts to ensure consistency and quality across Wikipedia's short description metadata.

Examples

[edit]

Common patterns for short descriptions include:

  • People: "American physicist" (for a scientist), "19th-century French painter" (for an artist)[1]
  • Places: "City in California, United States", "Mountain in the Alps"[3]
  • Species: "Species of bird", "Endangered species of South American fish"[1]
  • Concepts: "Mathematical theorem", "Economic theory"[2]
  • Events: "2020 sporting event", "Historical battle"[4]

Technical aspects

[edit]

Short descriptions are stored as page properties in Wikipedia's database and can be accessed through various APIs.[2] They are separate from the article's lead paragraph and do not appear in the rendered article text itself, though they may be visible in edit mode.[3]

The descriptions are automatically pulled by search engines and social media platforms when Wikipedia links are shared, making them an important part of Wikipedia's external presentation.[4] This metadata helps ensure that Wikipedia content is accurately represented across the internet.

See also

[edit]

References

[edit]
  1. 1 2 3 4 5 6 7 "Wikipedia:Short description". Wikipedia. Archived from the original on 2026-01-01. Retrieved 2026-02-05. Unknown parameter |deadurl= ignored (help)
  2. 1 2 3 4 5 6 "Wikipedia:Manual of Style". Wikipedia. Archived from the original on 2026-01-01. Retrieved 2026-02-05. Unknown parameter |deadurl= ignored (help)
  3. 1 2 3 4 5 "Wikipedia:Manual of Style/Layout". Wikipedia. Archived from the original on 2026-01-01. Retrieved 2026-02-05. Unknown parameter |deadurl= ignored (help)
  4. 1 2 3 4 "Wikipedia:Manual of Style/Text formatting". Wikipedia. Archived from the original on 2026-01-01. Retrieved 2026-02-05. Unknown parameter |deadurl= ignored (help)