1. Home
  2. Docs
  3. iSermons
  4. Shortcodes
  5. [isermons-list]

[isermons-list]

The main shortcode for displaying a grid or list of sermon posts, with optional search bar, taxonomy filters, and pagination.

Basic Usage

[isermons-list layout="grid" columns="3" per_page="9"]

Key Attributes

  • layoutgrid for a card grid layout, or list for a single-column list.
  • columns – Number of grid columns: 1, 2, 3, or 4. Only applies when layout is grid.
  • per_page – Number of sermons shown per page. Use -1 to show all sermons without pagination.
  • search – Leave empty to hide the search bar, or enter a placeholder text string to show it.
  • filters – Comma-separated list of taxonomies to show as filter dropdowns, e.g. filters="categories,series,preachers". Leave empty to hide all filters.
  • filters_operatorAND (sermon must match all selected filters) or OR (sermon must match any one filter).
  • meta_data – Comma-separated list of metadata fields to show on each sermon card, e.g. meta_data="preacher,date,series".
  • hoverenable to show a hover overlay with a play button on grid cards, or disable.
  • watch – Custom label for the watch/play button on sermons with video. Default: Watch Sermon.
  • relation – Taxonomy slug used for related sermon matching when placed inside the Details Page Related Sermons field.
  • imi_isermons-categories – Pre-filter by a specific category slug or ID.
  • imi_isermons-series – Pre-filter by a specific series slug or ID.
  • imi_isermons-books – Pre-filter by a specific book slug or ID.
  • imi_isermons-topics – Pre-filter by a specific topic slug or ID.
  • imi_isermons-preachers – Pre-filter by a specific preacher slug or ID.

[Screenshot placeholder: Frontend display of the [isermons-list] shortcode in grid layout — 3-column sermon cards with thumbnail, title, date, preacher name, and play button]

How can we help?