Status tag
Status tag
Introduction
The status tag has four types:
-
Neutral
-
Success
-
Warning
-
Danger
Each status tag has a filled and outlined appearance option and is available in three sizes.
Interactive example
When to use
Display a status tag to show the status of an item in an application. For example, status tags could be used to show if a system is online or offline, if a document has been actioned or approved, or if a displayed train network is currently active or not.
Filled
Filled status tags use the status colours to denote the type of status tag.
Use filled status tags to convey emphasis and importance.
Outlined
Outlined status tags use a lighter colour variation of the relevant status colour.
Use outlined status tags to provide emphasis to less important items.
![A good example of a success status tag labelled ‘approved’ used to show the status of a page titled ‘Guidance’.](/static/4933a6ddb32e162c1f74f7fd6620f5f4/6a008/fig-1-do-use-status-tags-exclusively-to-denote-status.png)
When not to use
Don't use status tags to display anything other than status, use
![An example of a status tag being used to display the author of a page.](/static/abb76b17586fac3f17c66463513cf047/6490e/fig-2-do-not-use-status-tags-for-anything-other-than-denoting-status.png)
Don't use a mix of filled and outlined status tags when using them together.
![An incorrect example of filled and outlined status tags being used in the same page section.](/static/c02ff87f80e033ae8cd07fd282fea8f2/d888b/fig-3-do-not-use-a-mix-of-primary-and-secondary-status-tags-to-show-the%20same-statuses-message-within-a-group-of-items.png)
Layout and placement
When components are used together the size of the components should match. For example, a default sized status tag should be used with a default sized input component.
![A good example of default sized status tags being used in the same section as other default sized components, and a small status tag being used in the same section as another small component.](/static/09314a574f5bafa51b37ee468204f3b8/a9266/fig-4-do-use-the-correct-status-tag-size-to-match-other-ui-component-sizes.png)
![An incorrect example of small sized status tags used in the same section as other default sized components, and a default status tag being used in the same section as a small component.](/static/2a03592fa6e41e1926784d664d8df819/a9266/fig-5-do-not-mix-sizes-when-using-multiple-ui-components.png)
Content
Labels
Use adjectives in the status tag label over verbs. Verbs may indicate to a user that by clicking on them the tag will be interactive.
Text in tags should be all capitals to increase readability.
![A correct example of a status tag which has the label 'submitted'.](/static/4b07a0618d679b64a50af8929310f61a/97765/fig-6-do-use-adjectives-to-describe-status.png)
Use the right status tag type that is relevant to the label. Don't use labels that convey different information to what the status colour conveys.
![A correct example of status tag labelling. The default variant has the label 'incomplete', the success variant has the label 'accepted’, the warning variant has the label 'in review', the danger variant has the label 'rejected'.](/static/d4dbf2b87d5406c5b5769da3b06607b9/19122/fig-8-do-use-relevant-wording-that-supports-the-status-tag-colour.png)
![An incorrect example of status tag labelling. The default variant has the label 'urgent', the success variant has the label 'error’, the warning variant has the label 'success', the danger variant has the label 'approved'.](/static/6b202bf4669ab90a09802b16f89f1d4a/19122/fig-9-do-not-use-wording-which-directly-contrasts-and-or%20does-not-support-the-status-of-the-tag.png)
Use concise labels for better readability. Longer labels will force the text to wrap.