Dynamic Card Group
An auto-populated card grid that dynamically queries and displays content items as cards. Content is sourced via item queries or search-based criteria, eliminating manual card creation for listing pages.
The example below shows a Dynamic Card Group rendering sourced from a search block. The rendering queries content items and renders each result as a card inside a card group (no gutters between cards). The ComponentType parameter controls which card rendering is used for each result, and PageSize limits the number of cards displayed.
Usage Notes
- The Dynamic Card Group uses the same
DynamicContainer.cshtmlview as other dynamic containers (Dynamic Components, Dynamic Carousel). The view iteratesModel.Placeholders["dynamicsection"]and renders each child component using the rendering engine’s component factory. - The datasource should be a Search Block item (located under
/Home/api/search/). The search block defines the query criteria that populate the cards. - The
ComponentTypeparameter is a Droplink to a dictionary item that tells the rendering contents resolver which component rendering to use for each result item. - The
PageSizeparameter limits the number of results rendered. If empty, all results from the search block are shown. ExplicitItemsallows manually specifying content items to include in the card group.AppendItemscontrols whether explicit items are appended to or replace search results.AdministrativeTagscan be used to filter results by tag taxonomy.- Cards are rendered inside a Bootstrap card group container (no gutters between cards), unlike the Dynamic Components rendering which uses a grid section with customizable gutters.
Control Properties
Standard Values / Defaults
| Parameter | Default Value |
|---|---|
| ComponentType | (empty) |
| PageSize | (empty — shows all results) |
| AdministrativeTags | (empty) |
| ExplicitItems | (empty) |
| AppendItems | (unchecked) |
Rendering Parameters
| Parameter | Type | Description |
|---|---|---|
| ComponentType | Droplink (dictionary) | Selects which card/component rendering is used to render each result item from the search block. |
| PageSize | Integer | Limits the number of cards displayed. Leave empty to show all results. |
| AdministrativeTags | Multilist | Filters results by administrative tag taxonomy items. |
| ExplicitItems | Multilist | Manually specified content items to include in the card group. |
| AppendItems | Checkbox | When checked, explicit items are appended to search results rather than replacing them. |
Template Properties
The Dynamic Card Group rendering does not use a traditional datasource template with content fields. Instead, the datasource is a Search Block item that defines the query criteria. The search block’s template fields (query path, template filter, sort order, etc.) determine which content items are returned and rendered as cards.
The actual card content fields depend on the rendering specified by the ComponentType parameter. Each result item’s fields are mapped by the selected card rendering’s model.