Overview
The List Hub component displays a visually styled list of links. Lists can be created manually or pulled from a Shared List Hub, making them reusable across multiple pages.
Common uses
- Curate a list of articles, tools, or pages
- Highlight related resources or services
- Reuse the same list across multiple pages (e.g., Quick Links, Student Services)
Component example
Component fields
| Element name | Required | Multiple |
|---|---|---|
|
Source
List source type. Choose Manual (list items created on the page) or Shared (reusable shared list).
|
Yes
|
No
|
|
Heading level
HTML heading level for each item title (H2, H3, etc.). Does not change visual style but ensures proper page structure.
|
Yes
|
No
|
|
Title
Optional. Label displayed above the list hub. Limit to a few words.
|
No
|
No
|
|
List item
Group containing fields for a single list item in a Manual List Hub. Add between 3 and 10 items.
|
Yes
|
Yes
|
|
List item title
List item title. Limit to a short phrase.
|
Yes
|
No
|
|
List item link
Optional. Destination Page or External Link.
|
No
|
No
|
|
List item eyebrow
Optional. Small label above the title. Limit to 1–2 words. Often used for a topic or category.
|
No
|
No
|
|
List item badge
Optional. Badge displayed beneath the text. Limit to 1–2 words (for example, "Required" or "Featured").
|
No
|
No
|
|
List item description
Optional. Short sentence beneath the title.
|
No
|
No
|
|
Shared list hub
Shared list to display. Visible only when Shared is selected.
|
Yes
|
No
|
Create a shared list hub
- Go to Add Content > Add Shared Element in the top-left menu.
- Select Shared List Hub.
- Enter your list hub content.
- Save your new list hub. All shared list hubs are saved to the
_shared-elementsfolder. - Publish your new list hub.
Update a shared list hub
-
In the WCMS, open the shared list hub you'd like to update in the
_shared-elementsfolder. -
Select Edit.
- Update the list hub content that needs changed.
-
Save and republish the list hub. All pages using that contact card will show the updated information.
You only need to republish the shared list hub itself to update it across your entire site. You don't need to republish each individual page a list hub appears on.
View all pages using a shared list hub
-
In the WCMS, open the list hub in the
_shared-elementsfolder. -
Select the Relationships tab from the More menu in the top-right.
-
Review the list of all pages that use the shared list hub.
Accessibility
-
Choose the correct heading levelMatch the list item heading level to the surrounding content (usually H2) to maintain a logical hierarchy.
-
Write clear link textLinks must describe their destination. Don’t rely on eyebrows or descriptions alone, since assistive tech users may not hear them. Avoid vague text like Read more.
-
Avoid redundant eyebrow and description textEyebrows and descriptions should add context, not repeat the same information already in the title or link.
Do
- Use to show a styled group of related links
- Keep titles and descriptions short and scannable
- Use eyebrows and descriptions when they add helpful context
- Use Shared List Blocks for link groups that appear on multiple pages