Widget builder how to

Use these steps to build, manage, and hand off CMS-configured widgets. For what CMS-configured widgets are and how they work with the SDK, see Widget builder concept.

Open the Widgets tab

To open the Widgets tab:

In Arena, go to CMS > Widgets.
The Widgets tab has Created and Archived views.

View and manage widgets

Widget list columns

In the Created view, the fields available are listed in the table that follows.

Column	What it shows
Widget remote ID	The CMS-generated ID for the widget configuration. For example, `xyz123`. This is the ID the developer needs.
Internal name	The CMS name that helps you identify the widget.
Data source	Labels referenced by the widget.
Type	The content type and layout, such as Moments and Row.
Status	The status you set for the widget: Available or In use.

Create a widget

To create a widget:

In Arena, go to CMS > Widgets.
On the Created tab, select Create widget.
The Create widget screen opens.
Navigate through the Setup, Data, and Design sections to complete widget settings.
Select Create.
A widget remote ID is assigned. The developer needs this to deploy the widget in the app.

Setup section

The setup tab has the options listed in the table that follows.

Area	Option	Description
Management	Content type	Select from Stories, Moments, or Videos. You can't change this later.
Management	Internal name	Enter a CMS-only name that helps you identify the widget in the list.
Management	Widget placement	Enter where the widget will appear in the app, such as a page or screen name. This helps you manage your widgets, but it doesn't affect how they display in the app.
Management	Status	Set the status yourself from the dropdown: Available In use
Layout	Type	Select from Row, Grid, or Single. You can't change this later.
Layout	Max items shown	Set how many items the widget displays.

Data section

On the Data tab, configure how the widget selects and orders content.

Area	Option	Description
Data source	Label condition	Select the labels that define which content appears in the widget. Each condition box is an AND condition (up to 5 labels per box). Select Add condition to add another box as an OR condition (up to 5 OR boxes). OR order sets priority Limitation: As set in labels.
Data source	Limit results	Turn on to limit the number of results returned by the data source.
Item order	Default order	Choose how items are ordered, such as As set in labels, Newest first, and so on.
Item order	Show unread first	Turn on to show unread items before read items.

Design section

On the Design tab, configure the widget's appearance. Appearance may vary slightly between different operating systems.

Area	Option	Description
Widget design	Design type	Choose how your layout is managed: Presets (predefined designs; select Vertical, Horizontal, or Circle for orientation). Widget presets are set by the developer and are common to all widgets in your app. In code (advanced design, such as colors, fonts, widths, backgrounds, and text sizes set by the developer in the SDK). The developer sets the layout in the context of the CMS-configured widget.

Edit a widget

To edit a widget:

In Arena, go to CMS > Widgets.
On the Created tab, find the widget by Internal name or use search and filters.
Select Edit, then change settings as needed.
Select Save changes.
CMS updates appear in the app after the widget loads or refreshes data again (for example, through the app's normal reloadData flow). Tell the developer that CMS edits are not pushed into an already-loaded session.

Topic	Description
Widget builder concept	What CMS-configured widgets are and how they work with the SDK
Widgets	Widget types and code-configured vs CMS-configured widgets
Labels and scheduling	Labels used in widget data sources