What is a widget and how to use them
Widgets are the building blocks of your page content. Instead of editing raw HTML for the whole page, you place widgets into regions defined by your template (layout).
Regions
A region (or placeholder) is an area of the page — for example Hero, a grid column, or Footer. Your template decides:
- Which regions exist
- How they are arranged (columns, rows)
When you edit page content, you drag widgets into these regions.
Adding a widget
- Open Pages → select a page → Content (or page editor).
- Find the Widgets panel (usually on the side).
- Drag a widget type into a region’s drop zone.
- Click Edit on the widget card to open settings (text, images, channel pickers, etc.).
- Save the page content, then Publish if you want it live.
Reordering and removing
- Drag cards within a region to reorder.
- Remove deletes that widget instance from this page only (it does not delete images from the library).
Widget categories
Typical groupings in the panel:
- Content — hero, navigation, rich HTML blocks
- Media — channel lists, single player, images from your library
- Advanced — custom CSS or JavaScript (use with care)
Each type has its own options; see the Widget reference section in the documentation index.
Page widgets vs layout defaults
- Page widgets — what you place on a specific page. They override layout defaults for that region.
- Layout defaults — optional site-wide widgets for a given layout file, configured under Layouts. If a region on a page has no page widgets, the layout default for that region may appear on the live site.
Customizing how a widget looks
Globally for your site, per widget type, you can override markup in Widget layouts (advanced). See Customize widget appearance.