Wikipedia:Manual of Style/Lists

This guideline is a part of the English Wikipedia's Manual of Style. It is a generally accepted standard that editors should attempt to follow, though it is best treated with common sense, and occasional exceptions may apply. Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page.

Shortcut MOS:LIST

This page in a nutshell: Lists present similar information in bulleted, enumerated, or definition format. Lists may be embedded in articles or may be stand-alone articles Lists should have a self-explanatory title, and a lead-in description with further explanation as required. Lists, categories, and navigation templates are synergistic.

Lists are commonly used in Wikipedia to organize information. Lists may be found within the body of a prose article, in appendices such as a "Publications" or "Works" section, or as a stand-alone article. This guideline explains when and how to use lists appropriately.

Wikipedia differentiates between articles that consist primarily of lists (generally called "lists" or "stand alone lists") and articles that consist primarily of prose (called "articles"). Articles are intended to consist primarily of prose, though they may contain some lists.

Stand-alone list articles

List articles are encyclopedia pages consisting of introductory material in the lead section followed by a list, possibly arranged in sub-sections. The items on these lists might include links to specific articles or other information, and must be supported with references like any article. The titles of stand-alone lists typically begin with the type of list it is (List of, Index of, etc.), followed by the article's subject, e.g., List of vegetable oils. They can be organised alphabetically, by subject classification or by topics in a flat or hierarchical structure.

The title and bullet style, or vertical style, is common for stand-alone lists. These Wikipedia articles follow the Wikipedia:Stand-alone lists style guideline.

Embedded lists

Embedded lists are

Embedded lists should be used only when appropriate; sometimes the information in a list is better presented as prose. Presenting too much statistical data in list format may contravene

"Children" (i.e., indentation)

It can be appropriate to use a list style when the items in a list are "children" of the paragraphs that precede them. Such "children" logically qualify for indentation beneath their parent description. In this case, indenting the paragraphs in list form may make them easier to read, especially if the paragraphs are very short. The following example works both with and without the bullets:

Lists of works and timelines

Lists of works of individuals or groups, such as bibliographies, discographies, filmographies, album personnel and track listings are typically presented in simple list format, though it is expected that the information will be supported elsewhere in the article by prose analysis of the main points, and that if the lists become unwieldy, they are split off into stand-alone lists per

"See also" lists and "Related topics" lists are valuable navigational tools that assist users in finding related Wikipedia articles. When deciding what articles and lists of articles to append to any given entry, it is useful to try to put yourself inside the mind of readers: Ask yourself where would a reader likely want to go after reading the article. Typically this will include three types of links:

• Links to related topics – topics similar to that discussed in the article
• Higher order (i.e., more general) articles and lists – this might include
  list of Indians and list of poets
  .
• Lower order (i.e., more specific) articles and lists – for example, the
  list of accounting topics
  , etc.

Most lists on Wikipedia are item lists, but not all. Specialized types of lists include:

• Outline – a Wikipedia outline is a hierarchically arranged list of topics belonging to a given subject. Outlines are one of the two types of general topics list on Wikipedia, the other being indices.
• Index – an index on Wikipedia is an alphabetical list of articles on a given subject. See Wikipedia:WikiProject Indexes
  .
• Timeline – a timeline is a graphical representation of a chronological sequence of events.
• command structure
  .
• discographies
  . Bibliographies are a list of relevant references for a subject area, including books, journal articles, and web articles; discographies are a listing of all recordings on which a musician or singer features, or may be compiled based on genre or record label
• Glossary – a glossary is a list of terms in a specific subject area, with definitions included.
• Set index article – document a set of items that share the same (or a similar) name. They are different from disambiguation pages in that they are full-fledged articles meant to document multiple subjects, while disambiguation pages are for navigation purposes only. Not all set index articles are lists.
• notable
  examples from a given category), or may require constant updates to remain current.

Lists have three main purposes:

Information

The list may be a valuable information source. This is particularly the case for a structured list. Examples would include lists organized chronologically, grouped by theme, or annotated lists.

Navigation

Lists which contain internally linked terms (i.e.,

Redundancy of lists and categories is beneficial because the two formats work together; the principle is covered in the guideline Wikipedia:Categories, lists, and navigation templates. Like categories, lists can be used for keeping track of changes in the listed pages, using the Related Changes feature. Unlike a category, a list also allows keeping a history of its contents; lists also permit a large number of entries to appear on a single page.

For a

Lists may be sorted alphabetically (e.g. for people: by surname, given name, initials), chronologically (by date, usually oldest first), or occasionally by other criteria. To suggest that a list in an article or section should be sorted, use {{Unsorted list}}.

Use prose where understood easily

Prefer prose where a passage is understood easily as regular text that appears in its ordinary form, without metrical structure or line breaks. Prose is preferred in articles because it allows the presentation of detail and clarification of context in a way that a simple list may not. It is best suited to articles because their purpose is to explain.

{{prose}} can be used to indicate a list which may be better-written as prose. Many stub articles can be improved by converting unnecessary lists into encyclopedic prose. See also: WP:Manual of Style/Trivia sections.

Use good markup

Use proper markup: Employ careful wiki markup- or template-based list code (see Help:List for many pointers). Especially do not leave blank lines between items in a list, since this causes the MediaWiki software to misinterpret each item as beginning a new list. (There are HTML techniques to insert linebreaks or additional paragraphs into a list item.) Avoid misuse of list markup in articles for visual styling of non-list material.

Images and lists

 [[File:Example.jpg|thumb|Caption text]]
 * Example 1
 * Example 2
 * Example 3
 * Example 4

 * Example 1
 * Example 2
 [[File:Example.jpg|thumb|Caption text]]
 * Example 3
 * Example 4

 * Example 1
 * Example 2
 * [[File:Example.jpg|thumb|Caption text]] Example 3
 * Example 4

To float pictures to the right of the list, one should put the image markup before the first item in most cases, see the example "A". Inserting the image markup as a separate line within the list (as in example "B") once again will split it into two half-lists.

Should the length of the list items or the topical relevance of said image discourage display at the top corner, consider placing it after the asterisk of the first list-item it illustrates (as in example "C") to avoid breaking continuity of the unordered list (<ul>) element.

Note: When floating images to the left of a list, use the {{flowlist}} template to prevent disrupting the indentation of the bullet-points.

Use an unordered list by default

Use a bulleted (unordered) list by default, especially for long lists. Use a numbered (ordered) list only if there is a need to refer to items by number, the sequence of items is important, or the numbering exists in the real world (e.g., tracks on an album).

Format list items consistently

List items should be formatted consistently in a list. Unless there is a good reason to use different list types in the same page, consistency throughout an article is also desirable.

Use

Lowercase is best reserved for:

• lists introduced by a sentence fragment, with a short list of items, also fragments, continuing the extended sentence;
• glossary entries, where it is important to convey whether something is usually capitalized or not;
• lists of items with non-English names (that have not been assimilated into English), from a language in which their capitalization would be incorrect.

Use the same grammatical form for all items in a list – avoid mixing sentences and sentence fragments as items.

• When the items are complete sentences, each one is formatted with
  sentence case (i.e., the initial letter is capitalized) and a final full stop
  (period).
• When the items are sentence fragments, the list is usually preceded by introductory material and a colon. Items may be given with initial lowercase or in sentence case. No final punctuation is used in most cases.
  • Semicolons may be used when the list is short, items are lowercase, and the entire list forms a complete sentence (typically with its introductory phrase and possibly with a closing phrase after the list to complete the sentence). Many cases of this are better rewritten as paragraphs unless it is contextually important to "listify" the items for clarity (e.g., because they correspond to sections in the rest of the article below the list).

Lists should have introductory material; for stand-alone lists, this should be the

Although lists may be organized in different ways, they must always be organized. The most basic form of organization is

Lists should never contain "Unsorted" or "Miscellaneous" headings, as all items worthy of inclusion in the list can be sorted by some criteria, although it is entirely possible that the formatting of the list would need to be revamped to include all appropriate items. Not-yet-sorted items may be included on the list's talk page while their categorization is determined.

List size

Keep lists and tables as short as feasible for their purpose and scope: material within a list should relate to the article topic without going into unnecessary detail; and statistical data kept to a minimum per

Some material may

Lists, whether they are

It is important to

Besides being useful for such feedback, a talk page discussion is also a good review process for reaching consensus before adding an item that is difficult or contentious, especially those items for which the definition of the topic itself is disputed. Note that, as with other policies and processes mentioned in this section, this process can be used for any type of difficult or contentious encyclopedic content on Wikipedia.

Reaching consensus on the talk page before editing the list itself not only saves time in the long run, but also helps make sure that each item on the list is

When an item meets the requirements of the Verifiability policy, readers of the list can check an item's reference to see that the information comes from a reliable source. For information to be verifiable, it also means that Wikipedia does not publish original research: its content is determined by information previously published in a good source, rather than the beliefs or experiences of its editors, or even the editor's interpretation beyond what the source actually says. Even if you're sure that an item is relevant to the list's topic, you must find a good source that verifies this knowledge before you add it to the list (although you can suggest it on the talk page), and add that source in a reference next to the item.

In lists that involve living persons, the

When reliable sources disagree, the policy of keeping a

When adding to a stand-alone list with

Categories

You can add one or more suitable subcategories of Category:Lists at the bottom of the page containing a list that may be of independent encyclopedic interest. If there is a redirect for the list (e.g., from "List of Presidents of Elbonia" to "President of Elbonia#List of Elbonian Presidents") put list categories on the "List"-named redirect instead. Use a sort key to sort alphabetically by topic.

There are several ways of presenting lists on Wikipedia.

Bulleted lists

This is the most common list type on Wikipedia. Bullets are used to discern, at a glance, the individual items in a list, usually when each item in the list is a simple word, phrase or single line of text, for which numeric ordering is not appropriate, or lists that are extremely brief, where discerning the items at a glance is not an issue. They are not appropriate for large paragraphs. Simple bulleted lists are created by starting a line with * and adding the text of a list item, one item per * line.

List items should be formatted consistently. Summary:

• Prefer
  sentence case
  .
• Prefer using full sentences, and avoid mixing sentences and fragments as items in the same list.
• No terminal punctuation is used with sentence fragments.
• Do not put blank lines between list items.

For details, see § Bulleted and numbered lists, above.

== Title of list ==
* Example 1
* Example 2
* Example 3

<h2><span class="mw-headline" id="Title_of_list">Title of list</span></h2>
<ul>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ul>

For infoboxes, a bulleted list can be converted to unbulleted or horizontal style with simple templates, to suppress both the large bullets and the indentation.

Do not double-space the lines of the list by leaving blank lines after them. Doing this breaks the list into multiple lists, defeating the purpose of using list markup. This adversely affects accessibility (screen readers will tell the visually impaired user there are multiple lists),^[1] and interferes with machine-parseability of the content for reuse. Moreover, in certain Web browsers, the extra white-space between one block of list output and the next can have a visually jarring effect.

Blank lines between items of a numbered list will not only cause the same broken-list problems as in bulleted lists, but will also restart the numbering at "1". This cannot be fixed without complex markup (defeating ease-of-editing expectations), so double-spacing should always be avoided in numbered lists.

== Title of list ==
* Example 1

* Example 2

* Example 3

<h2><span class="mw-headline" id="Title_of_list">Title of list</span></h2>
<ul>
<li>Example 1</li>
</ul>
<ul>
<li>Example 2</li>
</ul>
<ul>
<li>Example 3</li>
</ul>

Doing this actually produces three lists with one item each! Notice the rendered HTML in which there are as many <ul> tags as <li> tags.

Unbulleted lists

For lists of up to 30 items (may increase later) without bullets, use a {{Plainlist}} or {{Unbulleted list}} template. Typical uses are in infobox fields, and to replace pseudo-lists of lines separated with <br />. The templates emit the correct HTML markup, and hide the bullets with CSS (see Template:Plainlist § Technical details).

== Title of list ==
{{Plainlist|
* Example 1
* Example 2
* Example 3
}}

<h2><span class="mw-headline" id="Title_of_list">Title of list</span></h2>
<div class="plainlist">
<ul>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ul>
</div>

== Title of list ==
{{Unbulleted list
| Example 1
| Example 2
| Example 3
}}

<h2><span class="mw-headline" id="Title_of_list">Title of list</span></h2>
<div class="plainlist">
<ul>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ul>
</div>

A benefit of {{Plainlist}} is that it can be wrapped around an already-existing bullet list. A feature of {{Unbulleted list}} is that, for a short list, it can be put on a single line: {{Unbulleted list|Example 1|Example 2|Example 3}}.

Numbered lists

Use a numbered (ordered) list only if any of the following apply:

• There is a need to refer to the elements by number.
• The sequence of the items is critical.
• The numbering has some independent meaning, for example in a listing of musical tracks on an album.

Use a # symbol at the start of a line to generate a numbered list item (excepted as detailed in this section, this works the same as * for bulleted lists, above).

List items should be formatted consistently. Summary:

• Prefer
  sentence case
  .
• Prefer using full sentences, and avoid mixing sentences and fragments as items in the same list.
• No terminal punctuation is used with sentence fragments.
• Do not put blank lines between list items.

For details, see § Bulleted and numbered lists, above.

Example:

== Title of list ==
# Example 1
# Example 2
# Example 3

<h2><span class="mw-headline" id="Title_of_list">Title of list</span></h2>
<ol>
<li>Example 1</li>
<li>Example 2</li>
<li>Example 3</li>
</ol>

Blank lines between items of an ordered list will not only cause the same broken-list problems as in bulleted lists, but will also restart the numbering at "1". This cannot be fixed without complex markup (defeating ease-of-editing expectations), so double-spacing should always be avoided in numbered lists.

Experienced editors can use raw HTML to achieve more complex results, such as ordered lists using indexes other than numbers, and ordered lists not starting from 1.

<ol type="a">
<li>this</li>
<li>list</li>
<li>uses</li>
<li>letters</li>
<li>as</li>
<li>indexes</li>
</ol>

<ol start="10">
<li>this</li>
<li>list</li>
<li>starts</li>
<li>from</li>
<li>10</li>
</ol>

<ol type="I" start="50">
<li>this</li>
<li>list</li>
<li>uses</li>
<li>roman</li>
<li>numerals</li>
<li>and</li>
<li>starts</li>
<li>from</li>
<li>50</li>
</ol>

Valid values for the list type are:

• 1 (default, numbers)
• a (lowercase
  latin letters
  )
• A (uppercase latin letters)
• i (lowercase roman numerals)
• I (uppercase roman numerals)

The start value can be negative, but only if the list uses numbers as indexes. Otherwise, bizarre results are achieved.

<ol type="a" start="-2">
<li>definitely</li>
<li><b>not</b></li>
<li>a</li>
<li>good</li>
<li>idea!</li>
</ol>

Description (definition, association) lists

A description list contains groups of "... terms and definitions, metadata topics and values, questions and answers, or any other groups of name-value data."^[2][3] On Wikipedia, the most common use of a description list is for a glossary, where it is preferable to other styles. Wikipedia has special markup for description lists:

; name 1 : value 1
; name 2 : value 2
; name 3 : value 3

The source can also be laid out with the descriptive value on the next line after the term, like so:

; name 1
: This is the value associated with the first name and may be quite long, but must be one unbroken line in the source.
; name 2
: This is the value associated with the second name, which may also be long.

This still keeps the names and values within a single description list, and the alternation of typically short names and longer values makes the separate components easy to spot while editing. The resulting layout and HTML are identical to that generated by the single-line syntax.

Either wikitext markup is functionality-limited and easily broken. A major weakness of both variants of wikitext markup is that they are easily broken by later editors attempting to create multi-line values. These issues are most-prominent in lengthy description lists. As such, there are templates for producing description lists such as glossaries, in ways that provide for richer, more complex content, including multiple paragraphs, block quotations, sub-lists, etc. (For full details on the problems with colon-delimited list markup, see WP:Manual of Style/Glossaries/DD bug test cases.).

The basic format of a template-structured description list is:

Use either wikitext or templates as above for description lists instead of other, made-up formats, as other formats may be unexpected for reader and editor alike, hamper reusability of Wikipedia content, make automated processing more difficult, and introduce usability and accessibility problems. (Other formats may take less vertical space, but will be more difficult for the reader to scan.) That said, a list of items whose descriptions contain more than one paragraph may present better as sections in a stand-alone list article, while tables are better-suited to associating content than description lists, especially when there are multiple values for each item.

As with unordered (bulleted) and ordered (numbered) lists, items in description lists should not have blank lines between them, as it causes each entry to be its own bogus "list" in the output, obviating the point of putting the entries in list markup to begin with.

When wiki markup colons are used just for visual

Tables are a way of presenting links, data, or information in rows and columns. They are a complex form of list and are useful especially when more than 2 pieces of information are of interest to each list item. Tables require a more-complex notation, and should be scrutinized for their accessibility. Consideration may be given to

Tables might be used for presenting mathematical data such as multiplication tables, comparative figures, or sporting results. They might also be used for presenting equivalent words in two or more languages, for awards by type and year, and complex discographies.

Horizontal lists

In situations such as infoboxes, horizontal lists may be useful. Examples:

Note the capitalization of only the first word in this list ("Entry 1 ..."), regardless of coding style. Words that are normally capitalized, like proper names, would of course still be capitalized.

A benefit of {{Flatlist}} is that it can be wrapped around an already-existing bullet list. A feature of {{Hlist}} is that, for a short list, it can be put on a single line.

Timelines

For lists of dated events, or timelines, use one instance of {{Timeline-event}} per event, thus:

* {{Timeline-event|date={{Start date|1904|11|18|df=y}}|event=A thing happened}}
* {{Timeline-event|date={{Start date|1905}}|event=Not much happened}}
* {{Timeline-event|date={{Start date|1906|01|21}}|event=Something else happened}}

to render as:

• 18 November 1904 (1904-11-18): A thing happened
• 1905 (1905): Not much happened
• January 21, 1906 (1906-01-21): Something else happened

(note optional df=y (date first) parameter – date formatting should be consistent within individual articles).

Chronological lists, such as timelines, should be in earliest-to-latest chronological order. See Wikipedia:Stand-alone lists § Chronological ordering.

Line breaks

cake<br />
cheese<br />
chocolate<br />

This "pseudo-list" method is

problems. Instead, use one of more formatted list styles defined above.

Boilerplate text

Directly before an incomplete list, insert {{

transclude

the following onto the page:

This list is incomplete; you can help by adding missing items.