Skip to main content
Version: 17+

Feed Listing

The Feed Listing block lists the items of a Feed as cards, with paging and optional category and tag filters, sort options and a grid/list switch. It's usually placed on the Feed page itself: a Feed lists nothing until you add one.

To show just a few of the newest items on another page, use Latest from Feed instead.

Full width only

The Feed Listing always spans the full width of the page. Use Maximum Number of Columns to control how many cards sit side by side.

Content​

PropertyDescription
FeedThe Feed to list. Leave empty to use the current Feed (see Infer Feed).
Infer FeedUses the current Feed when no Feed is picked. On by default.
Pre HeadingShort text shown above the heading.
HeadingThe heading text and its size.
IntroAn introduction shown above the cards.
Empty TextShown when no items match, for example after a visitor filters.
Maximum Number of ColumnsHow many cards sit side by side. Leave empty for 3. Fewer columns are used on smaller screens.

Settings​

Rendering​

SettingDescription
Layout ModesGrid, List or both. Tick both to let visitors switch; the first is the default. Defaults to Grid.
Show Sort OptionsLets visitors change the order.
Default Sort OptionThe starting order: Newest, Oldest, Title A to Z, Featured or Manual. Leave empty to use the Feed's Item Sort Order.
Max Items Per PageHow many items per page. Leave empty for 9.
PaginationNumbered (default) page links, a Load more button, or None.
Show Category FilterLets visitors filter by category.
Category Filter StyleLinks (default), Checkboxes or Dropdown.
Show Tag FilterLets visitors filter by tag. Only tags used by the listed items are offered.
Tag Filter StyleLinks (default), Checkboxes or Dropdown.
Preset CategoriesOnly list items in these categories.
Preset TagsOnly list items with these tags.
Tag MatchWhether items need Any tag (default) or All tags of the preset tags.
Featured FirstLists items marked Featured before the rest.
Exclude Current ItemHides the item being viewed, when the listing sits on a Feed Item page.
Button StyleThe button style for the page links and the Load more button.
Filter Button StyleThe button style for the category and tag links and the Grid/List switch. Leave empty to use the Button Style.

How filters combine​

  • Picking several categories, or several tags, shows items that match any of them.
  • Using the category filter and the tag filter together shows items that match both.
  • Preset categories and tags always apply on top of what the visitor picks.

Filtered and paged views have their own address (for example ?category=events&page=2), so visitors can bookmark or share them. Filters work without JavaScript too.

Card settings​

These settings are on the Feed Item tab and control how each card looks. The same settings are used by Latest from Feed and the Related Items widget.

SettingDescription
Text AlignmentOptions: Left (default), Center, Right.
Vertical Text AlignmentOptions: Top (default), Center, Bottom.
Image PositionWhere the image sits on the card: Top (default), Bottom, Left, Right or Background.
Image Aspect RatioOptions: Original, 16:9, 3:2 (default), 4:3, 10:7, 1:1, 3:4.
Overlay StrengthHow dark the overlay is when the image is the card background, from 10% to 95%.
BoxedDraws a box around each card. On by default.
PaletteThe palette for the cards.
Show ImageOn by default. See Images for which image is used.
Card Heading LevelThe heading level for each card's title, H2 to H6. Defaults to H3.
Show DateOn by default.
Show SummaryOn by default.
Show CategoryShows the category above the heading. On by default.
Show TagsOff by default.
Show AuthorOff by default.
Read More TextAdds a "read more" link with this text. Leave empty to make the whole card the link.
Read More Button StyleThe button style for the read more link.

In addition to the above, the Feed Listing uses the shared common settings.