Tags are a short, scannable set of pill links that label a page or point to related topics.
What it is
Tags are a short, scannable set of pills that label a page or point to related topics. A set is one of two kinds — link tags, where each pill links to a page on this site or an external address, or text tags, plain labels with no link. They read as a group, so keep the set small and the labels tight. See Tags in the NSW Design System(opens in new window) for the visual specification.
A live example — select any tag to edit it in place. The last few pills come from a listing.
Add a Tags block, then fill it two ways — and you can mix both in the same set:
Link — a tag you write by hand (a label and where it links).
Listing — tags generated automatically from content on the site, so new pages show up as new tags.
Add a tag, then set where it links
Configure it
Tags
Choose the tag type in the sidebar — Links or Text — and the whole set follows it (a set is all one type, never mixed). Link tags each need an address: search for a page on this site to link to it, or paste a full web address for an external site. Text tags are just labels, with no address. Reorder tags by dragging; the whole set is shown at once (no paging).
Switch a tag's style — links become text
Tips
Keep labels to a word or two — tags are for scanning, not sentences. A handful reads best; a long wall of pills is hard to scan.
Use a Listing when the tags should keep themselves up to date with the site; write tags by hand when the set is fixed and curated. You can mix both in one block.