has been released! Read the upgrade guide


The documentation on this page is considered legacy.

We will be updating this content to our new principle-based format in the near future.


Display a list of items to the user.

The List component is an enhanced variation of the HTML unordered list. It provides space for a title and description.


Use the List component to display a visually clean set of list items.


  1. Container. The container wraps the entire list component.

  2. Title. The title for the List Item.

  3. Description. Accompanying text for additional context.

3Sizing & Spacing

The List component will automatically resize itself based on the content it is supplied with.

4Hierarchy & Placement

There are no restrictions over List placement.

The MOD.UK Design System provides guidance and tools for building high–quality Services within the UK Ministry of Defence. This project is open source and its source code is available on GitHub.

All content is available under the Apache 2.0 licence, except where otherwise stated.

© Crown copyright