Link list
A link list presents a short, curated set of links — the next best actions or related content for the page someone is on.
What it is
A link list is a short, scannable set of links — the next best actions or related content for the current page. Each item is a link with a short label. Links can point to a page on this site (an arrow marks the link), or to an external site — external links open in a new tab and show an external-link icon so people know they're leaving. See Link list in the NSW Design System(opens in new window) for the visual specification.
Example
A live example — select any link to edit it in place.
- Link list(opens in new window)
How to add it
Add a Link list block, then fill it two ways — and you can mix both in the same list:
- Link — a link you write by hand (a label and an address).
- Listing — links generated automatically from content on the site, so new pages show up as new links.
Configure it
Title
The link list has an optional Title, shown as a heading above the links. Leave it blank for a bare list.
Links
Each link has a label and an address. Search for a page on this site to link to it; or paste a full web address (https://…) for an external site — it opens in a new tab and shows the external-link icon automatically (as “Service NSW” does in the example above). Every link needs an address.
Linking to a page on this site also writes the label for you: pick the page and the link takes that page's title, and keeps it if the page is renamed. Type your own label to override it — that link stops following the page. An external address has no title to take, so you always write those yourself.
Tips
Keep labels short and scannable — a link list is for next best actions, not sentences. Aim for a handful of links, not a long index.
Use a Listing when the links should keep themselves up to date with the site; write links by hand when the set is fixed and curated. You can edit a link's label in place, right on the list.