Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Manual and dynamic collections

The items of a List or Grid block come from a collection - hand-picked (manual) or a query on the content tree (dynamic, query types Exponential and Topics). How to switch, what the dynamic options are, and how the same…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/build-two-ways/manual-and-dynamic-collections.md

On this page

Manual and dynamic collections

A block that lists content (List, Grid, the gallery blocks) has a collection. The collection is either:

TypeItemsTypical use
Manual collectionpicked by hand in the content browser, each one a node ID, in the order you set"Most popular articles", a curated teaser row
Dynamic collectionthe result of a query on the content tree, run when the page is rendered (and kept in the page caches like the rest of the page)"The newest articles of Fitness", "everything tagged Running"

Contents

  1. Switch the type
  2. The options of a dynamic collection
  3. The same in a template

Switch the type

Select the block, then on the Content tab press Change next to Collection type. The panel warns: Changing the collection type will remove existing manual items. Choose Dynamic collection, then the Query type, and press Apply.

The Collection type panel: Manual collection selected, the warning about manual items, Cancel and Apply
The Collection type panel: Manual collection selected, the warning about manual items, Cancel and Apply

The query types offered on this installation are Exponential (exponential_content_search, a search below a parent location) and Topics (content_by_topic, content with a tag).

The options of a dynamic collection

For Exponential the panel shows:

OptionMeans
Use current location as parentlist below the page being viewed instead of a fixed parent
Parent locationthe node below which to search; the folder button opens the content browser, View in CMS opens it in the administration
Sort typePublished, Modified, Alphabetical, Priority, Defined by parent
Sort directionDescending, Ascending
Advanced optionsfilters (content types, sections, object states)
Offset & number of itemsskip the first items, limit how many
A dynamic collection with the parent location Websites, sorted by published date, descending; the block preview lists the children
A dynamic collection with the parent location Websites, sorted by published date, descending; the block preview lists the children

The middle of the editor shows the result at once. On the test copy the three hand-picked items stayed at the top of the list after the switch, followed by the query result. The draft was then discarded with Discard.

The same in a template

The template way to list the newest articles below Fitness (node 92):

{def $latest = fetch( 'content', 'list', hash( 'parent_node_id', 92,
                                                'class_filter_type', 'include',
                                                'class_filter_array', array( 'ng_article' ),
                                                'sort_by', array( 'published', false() ),
                                                'limit', 3 ) )}
<ul>
{foreach $latest as $item}
    <li><a href={$item.url_alias|ezurl}>{$item.name|wash}</a></li>
{/foreach}
</ul>
{undef $latest}
Dynamic collectionfetch() in a template
Who changes the parent, sort, numberan editor, in the Layouts editora developer, in the template
Where it can appearin any zone of any layoutwherever the template is included
Lookthe block's view type and item view typethe template's own markup

Both read the same content tree. A common split: the template defines how one item looks (an item view type), the editor decides which items and where.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x