docs.modx.pro
  1. Extras
  2. PageBuilder
  3. Section catalog
  4. Pro
  5. Dynamic list

Dynamic list ​

Section dynamic_list shows provider rows at render time. Chunk: pagebuilderpro_dynamic_list. Requires PageBuilder Pro and capability datasources.

Providers: modx-resources, pagebuilder-tables, minishop3. In datasource you pick the provider and, when needed, a table key, filters, sort, and limit. Enrich calls DatasourceQueryService and passes items and total into the chunk.

Manager preview: mgr/datasource/query.

The section is part of the page context so the HTML cache does not freeze the live list. Without Pro the published HTML is not rebuilt: the type has requires: ["pro"].

Query ​

The query accepts only declared fields and operators eq, contains, in, gte, lte, between, empty, not_empty. QueryPolicy rejects keys sql, php, snippet, and class. A limit above 100 fails.

Fields ​

FieldTypeRequiredPurpose
titletextnoSection title
datasourcedatasourceyesProvider, filters, sort, limit
limitnumbernoRow limit

Render ​

ProSectionRenderSupport fills items. The row label follows pagetitle, then title, name, label, id. A link exists only when uri is set. Otherwise the label is a <span>.

A failed query is stored in query_error. Without capability datasources the text is Datasources are not available. An empty provider yields Datasource is not configured. An empty result uses lexicon pagebuilder_fe_list_empty, fallback No items.

Section data ​

json
{
  "title": "News",
  "datasource": {
    "provider": "modx-resources",
    "table": "",
    "filters": [{ "field": "parent", "op": "eq", "value": "5" }],
    "sort": [{ "field": "publishedon", "direction": "desc" }],
    "search": "",
    "limit": 20
  },
  "limit": 8
}

Similar sections ​