Widget reference

This page specifies all widget types available in Storyteq CMP portals, their configuration options, and their availability by portal type.

To add and configure widgets on a CMS page, use Add widgets to a CMS page.

Widgets are placed inside grids and carousels on CMS pages. Grids and carousels are section containers, not widgets, and are configured separately. Understanding CMS pages, grids, and widgets explains how these elements relate. To set up grids and carousels, use Add CMS grids and carousels.

Widget availability

The following table shows which widget types are available in each portal type.

Widget Dashboard Content Adaptations Collaborate Brand Portal Assets Projects Analytics Help

Asset Grid (Assets)

✓

✓

x

x

✓

✓

x

x

x

Asset Grid (Print T)

✓

✓

✓

x

✓

✓

x

x

x

Asset Grid (Digital T)

✓

✓

✓

x

✓

✓

x

x

x

Search Bar (Asset Listing)

✓

✓

x

x

✓

✓

x

x

x

Search Bar (Print Template Listing)

✓

✓

✓

x

✓

✓

x

x

x

Search Bar (Digital Template Listing)

✓

✓

✓

x

✓

✓

x

x

x

Search Bar (Project Listing)

✓

x

x

✓

x

x

✓

x

x

Typography

✓

✓

x

x

✓

x

x

x

x

Colour Palette

✓

✓

x

x

✓

x

x

x

x

Text

✓

✓

✓

✓

✓

✓

✓

✓

✓

Button

✓

✓

✓

✓

✓

✓

✓

✓

✓

Image

✓

✓

✓

✓

✓

✓

✓

✓

✓

Video

✓

✓

✓

✓

✓

✓

✓

✓

✓

Grid

✓

✓

✓

✓

✓

✓

✓

✓

✓

Carousel

✓

✓

✓

✓

✓

✓

✓

✓

✓

Tabset Section

✓

✓

✓

✓

✓

✓

✓

✓

✓

Project Listing Counter

✓

x

x

✓

x

x

✓

x

x

Gallery

✓

✓

✓

✓

✓

✓

✓

✓

✓

Widget specifications

Text widget

Text widgets display formatted content including headings, body text, lists, and links. The widget height grows dynamically as content is added.

General tab

Link

Enables an optional link on the widget. When the published widget is selected, the user navigates to the destination in a new tab. One of:

Internal

Links to a page within the portal.

External

Links to an external URL.

Asset Listing Link

Links to an asset list page.

Styles tab

Background Colour

A background colour applied to the widget. Select from the portal’s theme colours.

Opacity

The opacity of the background colour. Adjusted using a slider.

Border Radius

The corner radius of the widget in px.

Container tab

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left. Vertical and horizontal values are linked by default. Select to set each side independently.

Margin

Margin applied outside each side of the widget in px: top, right, bottom, and left.

Text editor

The text editor is opened by selecting on the widget. The following formatting options are available:

Option Description

Heading and text styles (TT)

Applies a heading level (Heading 1–6) or text style (Text, Text 1, Text 2) to the selected text. Styles are configured in Theming options reference.

Text colour

Applies a colour from the portal’s theme colours to the selected text.

Bold, Italic, Underline

Applies bold, italic, or underline formatting to the selected text.

Numbered list, Bullet list, Indent

Applies list formatting or indentation.

Vertical alignment

Sets the vertical alignment of text within the widget: top, centre, or bottom.

Link

Adds an inline link to selected text. Paste a URL directly, or highlight text first to use different link text. For mailto links, use the format mailto:emailaddress@example.com. Selecting a URL link in the published widget opens the destination in a new tab. Selecting a mailto link opens the user’s default email application addressed to the specified address.


Button widget

Button widgets display a labelled button that navigates to an internal page, external URL, or asset listing when selected.

General tab

Label

The text displayed on the button.

Button Style

The button style to apply. The styles come from the portal’s theming. For further information, refer to Theming options reference: Buttons. One of:

  • Primary

  • Secondary

  • Tertiary

Link

Enables an optional link on the button. When the published button is selected, the user navigates to the destination in a new tab. One of:

Internal

Links to a page within the portal.

External

Links to an external URL.

Asset Listing Link

Links to an asset list page.

Container tab

Padding

Padding applied to each side of the button widget in px: top, right, bottom, and left.

Alignment

Controls the position of the button within the widget container. One of:

Option Description

Left, Centre, Right

Horizontal alignment of the button within the container.

Stretch (horizontal)

Button width spans the full width of the widget container.

Top, Bottom

Vertical alignment of the button within the container.

Stretch (vertical)

Button height spans the full height of the widget container.


Image widget

Image widgets display an image selected from the DAM.

General tab

Asset

The image to display, selected from the DAM asset picker. Once set, can be replaced or deleted.

Image Quality

The quality at which the image is rendered. Defaults to High.

Image Size

Controls how the image fills the widget container. One of:

  • Contain (default): the image is scaled to fit within the container.

  • Cover: the image is enlarged to fill the container entirely.

Image Label

An optional text label for the image.

Link

Enables an optional link on the widget. When the published widget is selected, the user navigates to the destination in a new tab. One of:

Internal

Links to a page within the portal.

External

Links to an external URL.

Asset Listing Link

Links to an asset list page.

Focus Area

Controls which part of the image is displayed within the widget container.

Styles tab

Border Radius

The corner radius of the widget in px.

Container tab

Title

The display title of the widget. Defaults to Image.

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left.


Video widget

Video widgets display a video file selected from the DAM.

General tab

Video Size

Controls how the video fills the widget container. One of:

  • Contain: the video is scaled to fit within the container.

  • Cover: the video is enlarged to fill the container entirely.

Asset

The video file to display, selected from the DAM asset picker. The picker shows video files only. Once set, can be replaced or deleted.

Playback options

One or more of:

Option Description

Show Controls

Displays playback controls to the user in the published widget.

Autoplay

The video plays automatically when the page loads.

Mute

The video plays without sound.

Loop

The video repeats continuously.

Styles tab

Border Radius

The corner radius of the widget in px.

Container tab

Title

The display title of the widget. Defaults to Video.

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left.


Asset grid widget

Asset grid widgets display a grid of assets from a specified lens. Selecting an asset in the published widget opens the asset list page filtered to that lens.

The asset grid widget is available in the assets portal only.

General tab

Link Type

Determines how the widget links through to assets. One of:

Asset Listing Link

The widget links to an asset list page filtered by the configured lens.

  • Page Title: an optional title for the linked asset list page.

  • Lens (required): the lens that determines which assets display in the grid.

  • Sort By: the order in which assets display. One of: Name, Type, State, Date Created, Date Modified.

Internal Link

The widget links to an existing portal page.

  • Destination Page: the portal page to link to.

  • Sort By: the order in which assets display.

Layout tab

Columns

The number of columns in the grid.

Rows

The number of rows in the grid.

Gap

The spacing between grid cells in px.

Image Size

Controls how asset thumbnails fill each grid cell. One of:

  • Contain (default): thumbnails are scaled to fit within the cell.

  • Cover: thumbnails are enlarged to fill the cell entirely.

Styles tab

Background Colour

A background colour applied to the widget. Select from the portal’s theme colours.

Opacity

The opacity of the background colour. Adjusted using a slider.

Border Radius

The corner radius of the widget in px.


Search bar widget

Search bar widgets display a search field that directs users to a list of matching assets, print templates, digital templates, or projects. The widget’s link type sets what it searches and which settings it displays.

General tab

The General tab sets what the widget searches and where it directs users.

Link Type

Determines what the widget searches and where users are directed when they perform a search. The link types offered depend on the portal type, as shown in Widget availability. One of:

Asset Listing

Users are directed to an asset list page, with results filtered by the search term and the configured lens.

  • Page Title: an optional title for the linked asset list page.

  • Lens (required): the lens that determines which assets are available in the search.

  • Include assets from subdomains: includes assets from subdomains of the current domain. Not selected by default.

  • Include assets from parent domains: includes assets from parent domains of the current domain. Not selected by default.

  • Show only public: limits results to public assets. Not selected by default.

  • Enable descriptive search: lets users search by meaning instead of exact words. Not selected by default. When selected, the published widget displays Use descriptive search, and users can keep searching by meaning on the asset list page the search opens.

    What you see here depends on your workspace’s configuration. Enable descriptive search appears only where descriptive search is available for your organisation. To change it, contact your administrator.

  • Sort By: the order in which results display. One of: Name, Type, State, Date Created, Date Modified.

  • Search Fields: the fields users can search by. All fields are selected by default and can be deselected individually. One or more of: Name, Keywords, Types, States, and Privacy. Keywords searches by taxonomy keywords, and Privacy filters by whether assets are public or private.

Print Template Listing

Users are directed to a print template list page, with results filtered by the search term and the configured lens.

  • Page Title: an optional title for the linked print template list page.

  • Lens (required): the lens that determines which print templates are available in the search.

  • Include assets from subdomains: includes print templates from subdomains of the current domain. Not selected by default.

  • Include assets from parent domains: includes print templates from parent domains of the current domain. Not selected by default.

  • Sort By: the order in which results display. One of: Name, Type, State, Date Created, Date Modified.

  • Search Fields: the fields users can search by. Both fields are selected by default and can be deselected individually. One or both of: Name and Keywords.

Digital Template Listing

Users are directed to a digital template list page, with results filtered by the search term and the configured keywords.

  • Page Title: an optional title for the linked digital template list page.

  • Keywords: the taxonomy keywords that determine which digital templates are available in the search.

  • Sort By: the order in which results display. One of: Creation Date, Name, Modified Date.

Project Listing

Users are directed to a dynamically created project list page, with results filtered by the search term and the configured project types and states.

  • Page Title: an optional title for the linked project list page.

  • Project Type (required): one or more project types that determine which projects are available in the search.

  • Include Subtypes: includes subtypes of the selected project types. Not selected by default.

  • Include Subprojects: includes subprojects of the selected project types. Not selected by default.

  • Project State (required): one or more project states that determine which projects are available in the search.

  • Sort By: the order in which projects display. One of: Name, Type, State, Creation Date, Modified Date.

  • Search Fields: the fields users can search by. All fields are selected by default and can be deselected individually. One or more of: Name/ID, Keywords, Types, and States.

  • Search Operator: the logical operator applied between search terms. One or both of And, Or. Both are selected by default, and either can be deselected.

  • Allow Create Project: shows the Create New Project button on the project list page the widget opens. On by default.

Internal

Users are directed to the selected page in the selected portal, with results filtered by the search term.

  • Destination Portal: the portal that contains the page. Reviews is listed in workspaces where reviews are set up.

  • Destination Page: the page to direct users to. If no page is selected, users are directed to the first page they can access in the destination portal.

Styles tab

The Styles tab sets the widget’s background and corners.

Background Colour

A background colour applied to the widget. Select from the portal’s theme colours.

Opacity

The opacity of the background colour. Adjusted using a slider.

Border Radius

The corner radius of the widget in px.

Container tab

The Container tab sets the widget’s title, its spacing, and the position of the search bar.

Title

The display title of the widget.

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left.

Margin

Margin applied outside each side of the widget in px: top, right, bottom, and left.

Alignment

The vertical alignment of the search bar within the widget. One of: top, centre, bottom.


Asset search widget

The search bar widget replaces the asset search widget, which is no longer in the widget library. Asset search widgets already on CMS pages keep their name and work as before. They also have the Enable descriptive search setting, which works as it does for the search bar widget’s Asset Listing link type.


Project search widget

The search bar widget replaces the project search widget, which is no longer in the widget library. Project search widgets already on CMS pages keep their name and work as before.


Typography widget

Typography widgets display font families from typography assets stored in the DAM. Users can preview fonts in the published widget, and download the font files if downloads are enabled.

General tab

Assets

The typography zip files to display, selected from the DAM asset picker. Selected fonts display individually in the widget settings. Individual fonts can be removed from the selection.

Enable Download

When enabled, users can download font files from the published widget. A download button displays alongside the font selector in the published widget.

Styles tab

Text Colour

The colour of the font preview text. Select from the portal’s theme colours.

Background Type

Controls the widget background. One of:

  • None (default): no background applied.

  • Colour: select a background colour from the portal’s theme colours.

Border Radius

The corner radius of the widget in px.

Container tab

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left.

Margin

Margin applied outside each side of the widget in px: top, right, bottom, and left.


Colour palette widget

Colour palette widgets display a named brand colour palette on a CMS page. Palettes must be created in portal styling before they can be selected here. To create a palette, use the Create colour palettes section of Configure portal styling.

General tab

Layout

Controls the arrangement of colour swatches in the published widget. One of:

  • Columns: swatches are arranged in columns.

  • Rows: swatches are arranged in rows.

Palette (required)

The colour palette to display. Select from previously created palettes, or select + Add New Palette to create one without leaving the widget settings.

Show Values

When enabled, the hex, RGB, and CMYK values for each colour display in the published widget. Enabled by default.

Styles tab

Background Type

Controls the widget background. One of:

  • None (default): no background applied.

  • Colour: select a background colour from the portal’s theme colours.

Border Radius

The corner radius of the widget in px.

Container tab

Padding

Padding applied to each side of the widget in px: top, right, bottom, and left.

Margin

Margin applied outside each side of the widget in px: top, right, bottom, and left.

Gap

The spacing between colour swatches in px.


Project listing counter widget

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

The project listing counter widget is available in dashboard, collaborate, and project portals only.

General tab

Link Type

The type of listing launched when a user interacts with the published widget. One of:

Project Listing

Launches a dynamically created project list page filtered by the search term and the configured project type, states, and role.

  • Search Fields: the fields the search matches against (Name/ID, Keywords, Types, and States). All are selected by default and can be deselected individually.

  • Search Operator: the logical operator applied between search terms. One or both of And, Or. Both are selected by default and can be unchecked.

  • Allow Create Project: shows the Create New Project button on the project list page the widget opens. On by default.

Review Listing

Launches a dynamic review listing filtered by the configured settings.

  • Review Type: the types of review included in the count. Multi-select. Projects and Adaptations are both selected by default.

  • Review State: the review states included in the count. Multi-select. One or more of: Active, Aborted, Completed, and Draft.

  • Review Filters: optional filters to narrow the review count. One or more of: Requires my attention and Created by me. None are selected by default.

  • Sort By: the field used to sort results in the review listing. One of: Title, Created, Modified, Deadline, Started, and Completed.

Styles tab

Button Style

One of: Primary, Secondary, Tertiary.

Counter Colour, Heading Colour, Icon Colour

The colours applied to the counter value, heading text, and icon. Select from the portal’s theme colours.

Background Colour

A background colour applied to the widget. Select from the portal’s theme colours.

Opacity

The opacity of the background colour. Adjusted using a slider.

Border Radius

The corner radius of the widget in px.

Container tab

Title

The display title of the widget.

Padding / Margin

Padding and margin applied to each side of the widget in px: top, right, bottom, and left.


Gallery widgets display a rotating set of images or videos in a compact, resizable format.

The gallery widget is available in all portal types.

General tab

Autoplay Delay

The time in seconds each asset displays before the gallery cycles to the next.

Navigation

Controls which navigation controls display in the published widget. One or more of:

Option Description

Arrows

Displays previous/next arrows for manually cycling through assets.

Dots

Displays a set of dots indicating position within the gallery, used for manually cycling through assets.

Assets tab

Assets

The images or videos to display, added using Add Assets to open the DAM asset picker. Added assets are listed individually, for example Asset 1 and Asset 2.

Image Size

Controls how each asset fills the widget. One of:

  • Cover (default): the asset is enlarged to fill the widget entirely.

  • Contain: the asset is scaled to fit within the widget.

Styles tab

Background Colour

A background colour applied to the widget. Select from the portal’s theme colours.

Opacity

The opacity of the background colour. Adjusted using a slider.

Border Radius

The corner radius of the widget in px.

Container tab

Title

The display title of the widget.

Padding / Margin

Padding and margin applied to each side of the widget in px: top, right, bottom, and left.

Size

The widget’s height and width. Resized by dragging any edge or corner. There is no minimum width.