---
title: Unordered list
description: Use the unordered list component to present a collection of items without specific ordering.
keywords: ['bullet list']
---

## Anatomy

![Unordered list renders as a list with a visual indicator such as a checkmark](https://github.com/primer/brand/assets/912236/646a4719-dddf-47f5-9b34-85f6addb828e)

## Usage

Use an unordered list to group related items together. It is suitable for presenting a collection of items that do not require a specific order or ranking. The unordered list provides visual dashes for each item, which helps to emphasize the individuality of each point and makes it easier for users to scan and comprehend the information.

**✅ Do**

![](https://github.com/primer/brand/assets/912236/3746552a-8fd2-4fbf-9ad5-ed9b1bdcff0d)

_Use an unordered list to present and group a list of items that don't require a specific order._

**❌ Don't**

![](https://github.com/primer/brand/assets/912236/5df3fd9d-5508-48b1-a4e4-7891d6ecabb3)

_Don't use an unordered list to present a sequence of steps. Use an ordered list instead._

Use the unordered list to effectively provide a quick reference or highlight key points. This allows users to easily grasp the main ideas or features without having to read lengthy paragraphs. For lists that require a linear order, consider using an [ordered list](../OrderedList/index.md) instead.

The unordered list should have concise and short items. Avoid using long sentences or paragraphs as they can be difficult to scan and comprehend. If you need to include a long item or even headings and links, consider using a [pillar](../Pillar/index.md), a [card](../Card/index.md) or a [river](../River/index.md) instead.

**✅ Do**

![](https://github.com/primer/brand/assets/912236/990a350b-cc8c-42f1-88db-662b5609a179)

_Use an unordered list for short and concise content items._

**❌ Don't**

![](https://github.com/primer/brand/assets/912236/a416e1e6-58e6-4710-a2f9-646513853dcc)

_Don't use an unordered list for long and rich sentences, paragraphs, headings or links. Use a pillar, card or
river components instead._

## Options

### Variant

The unordered list uses a dash to indicate each item in the list. The dash is the default variant and is suitable for most use cases. You can use check icons to indicate a list of features or benefits that are supported by the application. This way users can easily check off or easily compare the features that they might be interested in.

**✅ Do**

![](https://github.com/primer/brand/assets/912236/afd68e16-0345-4085-b549-82647ca8136a)

_Use the check variant to indicate a list of features that are supported._

**❌ Don't**

![](https://github.com/primer/brand/assets/912236/7d8ddb4b-1a37-4b7b-a773-1eaeb9027d46)

_Don't include mutliple benefits in one single items, split them into multiple ones for better readability._

## Related components

- [Ordered list](../OrderedList/index.md): to display a list of plain content items.
- [Pillar](../Pillar/index.md): To display related content with less visual emphasis.
- [Card](../Card/index.md): to display navigational related content with higher visual weight.
- [River](../River/index.md): To display a list of content items with a visual asset.
