Skip to content

Content and Media Widgets

This page covers the widgets for text, single images, galleries, embedded pages, PDFs, testimonials and other content blocks. For each one it gives the steps to place it and the settings its form offers, in the words the form uses, so you can tell before you start which records and images you need to have ready.

Your job, and the screen for it

The jobScreen or tabRead
Add one of these widgets to a pageDesign Panel › Elements › Content & MediaConfiguration
Change a widget that is already on the pageClick it on the canvas, Design Panel › Selected NodeIts section under Configuration
Know which settings need an ID, JSON or rich textSelected NodeFields
Make a change reach the shopSAVE NODE, then PublishConfiguring Widgets
Find out why a widget shows nothingTroubleshooting

Overview

The Content & Media group in the Elements tab holds 17 widgets: audio-gallery, countdown-timer, iframe-display, image-card-widget, image-display, image-gallery, interactive-content-widget, media-play-list, our-services, pdf-viewer-widget, static-page-display, support-pages, testimonial-widget, text-widget, video-gallery, weather-tide-forecast-widget, weather-tide-forecast-widget-v2. Rich text in these widgets is edited with the editor described in Rich text and the Expand button. Placing, saving and publishing work the same for every widget and are explained once in Configuring Widgets in the Website Builder; this page adds what is particular to each widget.

Where it fits

BeforeThese widgetsAfter
You can open the Website Builder and the page exists — User Permission Manager, Layout InstancePlaced on a page and configuredShoppers see them on the storefront after Publish

Screens and menus

Open a page from the Layout Manager tile. In the Design Panel, the Elements tab lists these widgets under Content & Media, each with its one-line description; the search box matches the description too. Clicking a placed widget on the canvas opens its settings in Selected Node.

Configuration

Before you can use it

  • Everything in Configuring Widgets › Before you can use it: CP Commerce Admin for your login, and the records the widgets point at.
  • Check Platform before you drop a widget: it is added to that platform’s version of the page only.

audio-gallery

Audio gallery.

  1. In Elements, open Content & Media (or search audio-gallery) and drag audio-gallery onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Media display page (pick a page); Media folder (pick from list)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

countdown-timer

Countdown to a date and time.

  1. In Elements, open Content & Media (or search countdown-timer) and drag countdown-timer onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Countdown end date and time (date and time)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Set Countdown end date and time; the widget counts down to it.

iframe-display

Embedded web page (iframe).

  1. In Elements, open Content & Media (or search iframe-display) and drag iframe-display onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — URL; Scrollable
    • Frame — Height; Width; Top; Left; Bottom; Right; Margin; Margin top; Margin bottom; Margin left; Margin right
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

image-card-widget

Image cards.

  1. In Elements, open Content & Media (or search image-card-widget) and drag image-card-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Card details (a list; each item has Title, Icon, Image URL, Image link, Image link page, Is external link, Hide arrow); Font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

image-display

Single image.

  1. In Elements, open Content & Media (or search image-display) and drag image-display onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Image URL; Image link; Image link page; No padding margin; Query params (a list; each item has Query key, Query value › Product ID, Query value › Category group ID, Query value › Category ID); Shadow
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

image-gallery

Image gallery.

  1. In Elements, open Content & Media (or search image-gallery) and drag image-gallery onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Media display page (pick a page); Media folder (pick from list)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

interactive-content-widget

Interactive content with buttons.

  1. In Elements, open Content & Media (or search interactive-content-widget) and drag interactive-content-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Contents (JSON); Total container height; Total slider width; Slider background; Button style options (JSON)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

media-play-list

Audio / media playlist.

  1. In Elements, open Content & Media (or search media-play-list) and drag media-play-list onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Button details (a list; each item has Media folder, Page to open, Media image URL, Description); Media details (JSON)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

our-services

Cards for services or features.

  1. In Elements, open Content & Media (or search our-services) and drag our-services onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Title; Cards (a list; each item has Title, Subtitle, Image URL, Content, Button name, Button navigation URL)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Each card’s Content is rich text; a line break you type stays a line break on the page.

pdf-viewer-widget

PDF viewer.

  1. In Elements, open Content & Media (or search pdf-viewer-widget) and drag pdf-viewer-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — PDF viewer height; Container padding
    • Header style — Color; Background; Font
    • Container style — Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

static-page-display

Static page content.

  1. In Elements, open Content & Media (or search static-page-display) and drag static-page-display onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Post (pick from list); Container; Display photo; Enable cookie
    • Comment section params — Show comment section; Enable public comment; Comment form title
    • Comment section params › Body style — Color; Background
    • Comment section params › Button style — Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Pick the post to show in Post. Leave it empty to make one page that shows whichever post its address names — a link to the page ending ?post_id= and a post’s ID opens that post. Display photo shows the post’s photos. Edit the post itself to change the text; the page loads it each time it opens.

support-pages

Support / help page cards.

  1. In Elements, open Content & Media (or search support-pages) and drag support-pages onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Card details (a list; each item has Card URL › Length, Card logo › Length, Card label › Length)
    • Title — Length
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

testimonial-widget

Customer testimonials.

  1. In Elements, open Content & Media (or search testimonial-widget) and drag testimonial-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Testimonials (a list; each item has ID, Text, Author name, Author image, Media type, Media src); Background color; Shadow
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

text-widget

Rich text content block.

  1. In Elements, open Content & Media (or search text-widget) and drag text-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Content (rich text)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Content is rich text — type it here, with Expand for a larger editor. Tap to add content on the canvas edits the same text.

video-gallery

Video gallery.

  1. In Elements, open Content & Media (or search video-gallery) and drag video-gallery onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Media display page (pick a page); Media folder (pick from list)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

weather-tide-forecast-widget

Weather and tide forecast.

  1. In Elements, open Content & Media (or search weather-tide-forecast-widget) and drag weather-tide-forecast-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Image URL; Show home background image; Home background image URL
    • Style — Color; Font; Arrow color
    • Date content config — Margin; Margin top; Margin bottom; Margin left; Margin right
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

weather-tide-forecast-widget-v2

Weather and tide forecast (v2).

  1. In Elements, open Content & Media (or search weather-tide-forecast-widget-v2) and drag weather-tide-forecast-widget-v2 onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Image URL; Show home background image; Home background image URL
    • Style — Color; Font; Arrow color
    • Date content config — Margin; Margin top; Margin bottom; Margin left; Margin right
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Fields

The settings are listed with each widget above, in the form’s own words. Colours, lists and JSON behave as described in Configuring Widgets › Step 3.

Settings marked (pick a page) — their labels end in page — open a list of your pages when you click them and fill in the page’s address, /page/ and its code. You can also type any link instead, such as a full https:// address. Left empty, the widget uses its own default page where it has one.

The settings that pick a record, take JSON or hold rich text:

KindWhereWhat to know
Rich textour-services › Content; text-widget › ContentFormatted text with links and images; Expand opens a large editor. Emptying the editor removes the setting
Typed as JSONinteractive-content-widget › Button style options; interactive-content-widget › Contents; media-play-list › Media detailsInvalid JSON shows JSON is invalid and is not saved; the last valid value stays
Media foldersaudio-gallery › Media folder; image-gallery › Media folder; media-play-list › Media folder; video-gallery › Media folderPick the Media Library folder by name; the widget shows what is in it. A saved one that is not in the loaded list shows as Not in the list — saved ID …; publish, then reload, before you replace it — a reload loses unpublished changes
Postsstatic-page-display › PostPick the post by its title; the most recently updated are at the top, and the list holds the first 1,000. A saved one that is not in the loaded list shows as Not in the list — saved ID …; publish, then reload, before you replace it — a reload loses unpublished changes

Lifecycle and effects

SAVE NODE keeps a change in your browser tab only; Publish sends the page to the shop, and a reload before publishing loses the change. A setting left empty is not saved and the widget uses its own behaviour for it; opening a widget and saving without changes leaves its stored settings as they were. The full sequence is in Configuring Widgets › Lifecycle and effects.

Related applets

  • CP Commerce Admin — decides who may publish, and holds the same pages under Layout Instance.
  • Media Library — where the images these widgets show are uploaded.

Troubleshooting

SymptomCauseFix
The widget is empty on the shopA record it shows is missing or inactiveCheck the records its pickers point at
A change is gone after reloadThe page was not publishedRedo it and Publish before leaving
It shows on desktop but not on phonesIt was added on a desktop platform onlySwitch Platform and add it there too
SAVE NODE does nothingWidget Config (JSON) holds invalid JSONFix or undo the JSON
A picker shows Not in the list — saved ID …The record it saved was deleted, belongs to another website, or is not in the list as loadedPublish what you have first (a reload loses unpublished changes), then reload; if it still shows, check the record before you pick a replacement
A picker shows The list is empty or could not be loadedNothing of that kind exists yet, or loading failedCreate the record first, or reload the page
static-page-display shows nothingPost is empty and the page address names no postPick a Post, or open the page through a link ending ?post_id= and the post’s ID

Related documentation

Last updated on