Lists

Lists help break content into smaller, easier-to-read pieces. They work well when you need to show steps, requirements, options, or key points without forcing users to read a large block of text. A good list makes content easier to scan and easier to understand.

 

Use lists when they make content clearer

Lists are useful when the content includes:

• steps in a process

• requirements or qualifications

• documents users need to submit

• options or choices

• key reminders or takeaways

 

If you are writing a sentence with several items separated by commas or semicolons, that may be a sign the content would work better as a list.

 

Choose the right type of list

Use the list type that best matches the content.

 

Use a bulleted list when:

• the order does not matter

• the items are all part of the same group

• you want users to scan key points quickly

 

Use a numbered list when:

• the order matters

• the content explains steps

• users need to complete items in sequence

 

Keep list items short and consistent

Try to keep list items concise. Each item should follow a similar style and structure so the list feels easy to read.

 

Better

• Submit your application

• Upload required documents

• Check your email for updates

 

Less clear

• Submit your application through the portal

• Required documents should be uploaded

• After that, students will receive an email with updates

 

The first version is easier to scan because the items are parallel and direct.

 

Introduce the list clearly

Add a short sentence before the list so users know what they are looking at. The line before the list should lead naturally into the items that follow.

 

Example

 

You may need the following documents:

• photo ID

• proof of residency

• immunization records

 

This works better than dropping a list onto the page without context.

 

Do not use lists just for visual spacing

Lists should be used when items belong together in a meaningful way. Do not turn short paragraphs into bullet points just to make the page look cleaner. If the content is really a paragraph, keep it as a paragraph.

 

Also avoid using lists when each item becomes too long. If every bullet turns into a full paragraph, the content may need headings or shorter sections instead.

 

Keep lists easy to scan

Long lists can become hard to use. When a list starts getting too long, look for ways to group or simplify it.

 

You can improve long lists by:

• grouping related items under short headings

• breaking one long list into smaller sections

• removing repeated or unnecessary items

• moving extra explanation below the list when needed

 

The goal is to help users find what matters quickly.

 

Be careful with numbered lists

Use numbered lists only when the order truly matters. Numbers suggest a sequence, so do not use them for a simple group of related items unless users are expected to follow them in order.

 

Use numbered lists for:

1. Complete the request form.

2. Attach supporting documents.

3. Submit the form for review.

 

Use bullets for:

• website updates

• accessibility fixes

• content corrections

 

Do not build fake lists with symbols or spacing

Use real list formatting in the editor instead of typing dashes, asterisks, or numbers by hand. Real lists are easier to maintain and more consistent across the site.

 

This also helps keep spacing, alignment, and formatting clean.

 

Before publishing

Use this quick review before adding or approving a list:

• A list is being used because it makes the content clearer.

• Bullets are used when order does not matter.

• Numbers are used when order does matter.

• The list has a short introduction when needed.

• The items are concise and written in a consistent style.

• The list is not so long that it becomes hard to scan.

• Real list formatting was used in the editor.

 

Related guidance: Content Development, Define the Purpose of Page, Links, and Tables.