Listing
Listing of cards and other content with multiple filters, search, and pagination, great for resource libraries or other content-heavy sections that need clear categorization and easy navigation. Set 1 to 4 columns. Supported content types include Team card, Content card, Cover card, Go card, and Rich text.
Live Preview| Use case | Filter and search content by category or keyword. |
| Page speed impact | The component itself has Low impact, but depending on the number and size of images, especially above the fold, it may have Medium or even High impact. Optimize images with TinyPNG or prefer vector images (SVG) when possible. |
| Available in pages | Yes |
| Reserved block class | listing |
| Relevant files | css/components/listing.cssjs/components/listing.js |
Quick demo
Good to know
See this module in action by creating a test page with the Resources template, which comes with multi-filters and sample cards already set up.
When defining filters, make sure category names only contain letters, numbers, underscores, or hyphens. Spaces and special characters are not supported:
When adding categories to your cards, you can use spaces to separate multiple categories:
Filtering listings with #hash
You can filter listing content using the URL hash. This is useful for linking to a pre-filtered view from another page or from the menu.
You can do that by appending something like this to your URL:
#filter=online-marketing,guides
Multiple categories are separated by commas.
If you have multiple Listing modules on your page, you need to add a unique ID to each listing. For example:
Then specify it in your URL like this:
#list=list1&filter=online-marketing,guide
To scroll to a specific element when filtering with #hash, such as a Section intro, specify the element's ID like this:
#list=list1&filter=online-marketing,guide&scroll=list1Top
See a live example and an example with multiple listings on the same page.
Here is an example of a relative URL for linking from a menu or another page on your website:
/case-studies#filter=startup,healthcare