ExplanationUnderstand the concepts

Understanding CMS pages, grids, and widgets

A CMS page is a free-form content page that an implementer builds using grids and widgets. Unlike list pages, CMS pages do not pull data from a lens. They exist to present editorial, brand, or structural content, such as landing pages, brand guidelines, or help content. CMS pages are available in all portal types.

Content on a CMS page is organised into sections, each containing a grid or a carousel:

  • A grid defines the column and row structure that widgets sit within. Multiple sections can be added to a page and reordered as needed.

  • A carousel displays content in a horizontally scrollable format and is an alternative to a grid where that presentation suits the content better.

Widgets

Widgets are the individual content elements placed inside a grid or carousel. The following widget types are available:

  • Text: formatted text content. Supports headings, lists, inline links, and mailto links, and can be configured with a background colour and padding.

  • Button: a labelled button that links to an internal page, an external URL, or an asset listing. Button colour, alignment, and padding are configurable.

  • Image: an image selected from the DAM. Image quality, sizing (contain or cover), focus area, and an optional link are configurable.

  • Video: a video file selected from the DAM. Playback options include autoplay, loop, mute, and show controls.

  • Asset grid: a grid of assets from a specified lens, linking through to an asset list page. Column and row layout, image sizing, and background colour are configurable.

  • Asset search: a search field that returns assets from a specified lens. Search can be scoped by name, keywords, states, and types.

  • Typography: font families from typography assets stored in the DAM. Users can switch between fonts and optionally download font files if this is enabled in the widget settings.

  • Colour palette: a brand colour palette created in the portal’s theming settings. Layout (columns or rows) and background colour are configurable.

  • Project search: a grid of projects from a specified project type and project states, linking through to a project list page.

  • Project listing counter: a count of projects or reviews matching configured filters, linking through to a project list or review listing page.

  • Gallery: a rotating set of images or videos in a compact, resizable format.

Not all widget types are available in all portal types. Widget reference lists which widgets are available in each portal type.

Localisation

CMS pages can have locale-specific versions, allowing different content to be presented to users based on their locale setting. Each locale is edited independently within the same page. If no localised version exists for a user’s locale, the portal displays the default locale version instead.

To set up locale versions, use Localise a CMS page.