Choose the best list type

Choose the appropriate list type for your content by considering the importance of item order and the need for descriptions or definitions.

You can use the following list types based on your content.

Before you include a list in your documentation, review Best practices for writing lists.

Type of list When to use More information
Unordered, or bulleted, list When the list item order isn't important, such as a list of options. See Unordered lists.
Ordered, or numbered, list When the order of the list items is important or the user is following sequential steps, such as a task. See Ordered lists.
Definition list For a list of descriptions, definitions, associations, or explanations, such as a glossary or a set of terms. See Definition lists.