Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Components

List

Use: Deployed Web
A list organizes information into discrete sequential sections.

Examples

Default

Simple unordered and ordered lists

  • Unordered list item
  • Unordered list item
  • Unordered list item
  1. Ordered list item
  2. Ordered list item
  3. Ordered list item
Definition list title one
Definition list item
Definition list item
Definition list title two
Definition list item
Definition list item

More complex unordered and ordered lists

  1. July 10, 2023 letter

    Board Of Appeals Decision Letter

  2. July 7, 2023 letter

    Board Of Appeals Decision Letter

Usage

Additional guidance for VA

Choosing between variations

  • Use unordered lists when the order of the items is not relevant. List items in unordered lists can be in any order and are indicated with a black square.
  • Use ordered lists for sequential information. Ordered lists are automatically enumerated by the browser.
  • Use description lists for groups of related terms and descriptions. List items parts in definition lists will be connected programmatically.

Instances of this component in production

Will VA cover the cost of eyeglasses?

We'll cover the cost of your eyeglasses if you meet at least one of the requirements listed below.

At least one of these must be true. You:

  • Have a compensable service-connected disability (a disability linked to your military service for which you're receiving VA disability payments), or
  • Are a former prisoner of war (POW), or
  • Were awarded a Purple Heart, or
  • Receive benefits under Title 38 United States Code (U.S.C.) 1151, or
  • Receive an increased pension based on your being permanently housebound and in need of regular aid and attendance

Or, you must have at least one of these issues:

  • Vision problems caused by an illness—or the treatment of an illness—for which you're receiving VA care, like:
    • Stroke
    • Diabetes
    • Multiple sclerosis
    • Vascular disease (diseases that affect your blood vessels)
    • Geriatric chronic illnesses (long-lasting illnesses that affect the elderly)
  • Vision problems caused by an injury—or the treatment of an injury—for which you're receiving VA care, like:
    • A reaction to prescribed medicines
    • Cataract surgery or other surgeries of the eye, ear, or brain
    • Traumatic brain injury or polytrauma (injuries to more than 1 body part or organ, often caused by a blast)

An example of unordered lists, with nested list items, from a vision care health benefits page.

If you meet the eligibility requirements on this page, you can get these supplies free of charge:

  • Hearing aid supplies
  • CPAP supplies
  • Prosthetic socks

An example of an unordered list in an Accordion component.

Eligibility to order medical supplies

You may be eligible to order certain free medical supplies from us if you meet all of these requirements.

All of these must be true:

  • You're enrolled in VA health care, and
  • You're registered as a patient at a VA medical center, and
  • Your VA provider prescribed the supplies or the related medical device (such as hearing aids or a CPAP machine)

Find out how to apply for VA health care

An example of an unordered list in a Summary box where items are concatenated using and.

List of appointments in VA.gov.
An example of an inline list of appointments where each list item is a row containing appointment details.

Your VA claim letters

You can download your claim letters. We also mail you these letters.

July 10, 2023 letter

Board Of Appeals Decision Letter

July 7, 2023 letter

Board Of Appeals Decision Letter

An example of a list of Claim letters from VA.gov.

Documents filed

VA Medical Records

Submitted: June 18, 2023

Service Treatment Records

Submitted: June 17, 2023

Personnel Records

Submitted: June 17, 2023

VA 21-526EZ, Fully developed claim

Submitted: June 15, 2023

An example of a list of documents filed with the VA.

Code usage

Lists use standard HTML elements (<ul>, <ol>, and <dl>) and do not require a web component. Refer to the U.S. Web Design System list component for detailed code usage guidance.

Content considerations

  • Select the list type. Use numbered (also called “ordered”) lists when giving steps that someone must follow in a specific order. Use bulleted (also called “unordered”) lists for any list that doesn’t require a specific order.
  • Introduce the list. Introduce the list with a full sentence. Avoid using “the following” in the list introduction and use a less formal phrase instead. For example, instead of “You’ll need the following documents,” use “You’ll need these documents.”
  • Don’t combine the list items’ starting word or phrase with the introduction. For example, don’t introduce the list with “All of these must be true. You’re:” In this case, each item should start with “You’re.” This helps when the content needs to be translated into another language.
  • Avoid using sub-bullets. Sub-bullets can make the content harder to scan. If possible, make the item with sub-bullets a separate list.
    Note: Bulleted lists can be used in step-by-step lists.
  • Keep each item in a list succinct. Aim for no more than 1 or 2 sentences per list item to keep lists easy to scan.
  • Connect items appropriately. When using “and” or “or” at the end of each list item, use a comma and bold the “and” or “or” at the end of each item.
    Note: Don’t use “and/or” in lists. Instead, restructure the content to list all options (for example, “your income and/or net worth” should be “your income, your net worth, or both”).
  • Keep each list to no more than 7 items. If your list has more than 7 items, use subheads to break up the list into smaller, easier-to-digest lists.
  • Use parallel construction within a list. Each list item should be consistent. For example, starting with a verb or noun phrase.
  • Use sentence case. Capitalize the first word in each list item, even if the item isn’t a full sentence.

Accessibility considerations

  • Unique headings and link text. For complex list items that are comprised of more than one line of content (e.g. header, description, link, etc.) ensure that any headings and link text within the list are unique.

Component checklist

Web Platform

50%

5 of 10 complete

Maturity

Guidance

Web

Examples, usage, code usage, content considerations, and accessibility considerations are all complete.

Research

Web

VFS team conducted research on this component which is linked from this page.

Stability

Web

Component has been in production for more than 3 months with no significant issues found.

Adoption

Web

Multiple teams have adopted this component.

Accessibility

While this component has been previously tested against older criteria, it has not yet been audited with the updated testing criteria.

Code assets

Variations

Web

Storybook includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component depicted in all responsive breakpoints.

Interactive states

Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Internationalization

N/A Web

Describes i18n attributes.

Visual assets

Variations

Web

Figma library includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component designed to work in all responsive breakpoints.

Interactive states

Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Legend:

  • Complete
  • Incomplete
  • N/A Not applicable

Provide feedback

Share your feedback, report issues, or suggest improvements for the List component. Your input helps us make the design system better for everyone.

Edit this page in GitHub (Permissions required)
Last updated: Sep 09, 2026