Skip to content
  1. Extras
  2. PageBuilder
  3. Getting started
  4. System settings

System settings

MODX namespace: pagebuilder. Database key: pagebuilder_<name>.

The extra manifest defines 16 keys. On install or upgrade, the resolver adds missing keys. Existing values are not overwritten.

Paths and preview

KeyTypeDefaultDescription
pagebuilder_core_pathtext{core_path}components/pagebuilder/Path to PHP core
pagebuilder_assets_urltext{assets_url}components/pagebuilder/URL for connector, preview, assets
pagebuilder_preview_secrettextfrom resolver / site_uuidSecret for draft preview token
pagebuilder_load_frontend_cssboolean1Register pagebuilder-sections.css when calling PageBuilder
pagebuilder_preview_include_template_cssboolean1Load template <link rel="stylesheet"> in preview iframe
pagebuilder_preview_css_urlstextareaemptyExtra CSS for preview (comma-separated), placeholders {assets_url}, etc.

Empty pagebuilder_preview_secret falls back to site_uuid. On production, set a dedicated secret if manager preview should not rely on a predictable UUID.

Preview iframe CSS order (preview.php):

  1. Resource template stylesheets when pagebuilder_preview_include_template_css = 1
  2. URLs from pagebuilder_preview_css_urls (comma or newline separated)
  3. pagebuilder-sections.css and pagebuilder-preview.css

If the theme loads CSS only via Fenom or @import without <link>, list files explicitly in preview_css_urls. Placeholders: {assets_url}, {base_url}, {site_url}.

Resource form tabs

KeyTypeDefaultDescription
pagebuilder_resource_tab_enabledboolean0“Sections” tab on the resource form
pagebuilder_resource_tab_parentstextemptyParent IDs comma-separated. Empty when enabled = all resources
pagebuilder_resource_tab_indexnumber-1“Sections” tab position: 0 first, 1 second, -1 last
pagebuilder_resource_tables_tab_enabledboolean0“Tables” tab (tabular resource data)
pagebuilder_resource_tables_tab_indexnumber-1“Tables” tab position

Collections (CMP)

KeyTypeDefaultDescription
pagebuilder_collections_enabledboolean0Dynamic multi-tab from CMP Collections
pagebuilder_collections_modx_bridge_enabledboolean0Tab type modx_collections

Enable only if you use Collections and configured tab config in the PageBuilder CMP. Details: CMP → Collections.

Tabular resource data

Resource Tables tab (pagebuilder_resource_tables_tab_enabled) or tab type table in Collections.

ProcessorPurpose
mgr/datatable/listResource tables
mgr/datatable/rows/listRows: search, page, limit, filters
mgr/datatable/rows/save / removeRow CRUD

Column filter JSON: { "price": { "op": "gte", "value": "10" } }. Operators: eq, contains, in, gte, lte, between, empty, not_empty.

On the front: PageBuilderTableRows snippet, data_table section. Details: Developer.

Editor

KeyTypeDefaultDescription
pagebuilder_fake_enabledboolean0Fake button in the section inspector: fills fields with deterministic demo data (mgr/section/fake)

Public API

Read-only JSON for headless frontends. Details: Public API.

KeyTypeDefaultDescription
pagebuilder_public_api_enabledboolean0Enable assets/components/pagebuilder/api.php
pagebuilder_public_api_keytextemptyAPI key. Empty allows unauthenticated requests (dev only)
pagebuilder_public_api_cors_originstextarea*Allowed CORS origins for browser clients

Snippet relation

SettingSnippet paramBehavior
pagebuilder_load_frontend_cssload_cssParam overrides system setting
wrap_pageWrapper <div class="pb-page"> (default follows load_css)

Params load_css and wrap_page are set on the snippet call only; they are not listed in snippet properties.