Skip to main content

Lists

How to make your lists readable and useful.

Why lists are important

Bulleted lists break up large blocks of text and make reading complex information easier.

Lists break up collections of similar items into more manageable chunks that are easier to read and use.

Numbered lists are useful for information where the order of steps is important.

Guidelines

Use lists to split up long sentences.

Lists should:

  • complete a sentence
  • be front-loaded with the most important information
  • start with the same language element, like verb, noun, adjective
  • be short (2 to 7 items)
  • use only 1 level of nesting
  • be grammatically correct.

How to use single sentence lists

For single-sentence lists:

  • start with a stem sentence that all the points have in common
  • start each point in lower case, and only use a full stop on the last point
  • check that each point makes a full sentence when read with the stem.

If appropriate:

  • use ‘and’ or ‘or’ on the second-to-last point
  • place a comma after the last word before the ‘and’ or ‘or’.

How to use multi-sentence lists

Multi-sentence lists are introduced by a complete sentence.

  • Each point in the list is also a complete sentence.
  • Each point can be 1–3 sentences long.
  • Each point begins with a capital letter and ends with a full stop.

Code for lists

The ordered list element — MDN Web Docs

The unordered list element — MDN Web Docs

Utility links and page information

Did you find what you are looking for?

Your feedback will help us improve this website.

Thanks, do you want to tell us more?

Do not enter personal information. All fields are optional.

Page last updated: