Rich Text Widget

Set the title of the widget. Include a descriptive title to help users understand the specific content of the widget.

Select whether to wrap title text that extends beyond the available display width. When not selected, long titles are truncated with an ellipsis.

Add a description for the widget. This description displays below the widget title.

Select whether to display the widget description as a tool tip, hiding it by default.

When displayed as a tool tip, any rich text formatting in the description is removed.

Change the widget icon and icon color—or remove the icon. Widgets always include a default icon.

Select the crossed-out icon option, , to remove the icon.

Set the display width of the widget.

The width settings of neighboring widgets determine the resulting display on the interface. For example, two neighboring widgets set to 50% width display side by side. Similarly, if one widget is set to 1/3 and the following widget is set to 2/3, the widgets will display side by side.

We recommend experimenting with widget width settings and widget placement to optimize the interface display for the screen size you're designing for. That is, if you're designing an interface for a large screen (say, a request tracking interface), you can use small widget widths and include multiple widgets together. However, if designing for mobile, leaving widgets at 100% widths is generally best.

Select whether to dynamically display the widget based on custom conditions. When enabled, a conditions group displays; when the specified conditions are met, the widget displays.

For example, you can set a condition to display an input-type widget only if a user enters a specific value, prompting the user to provide additional information.

For more information about configuration condition groups, see Conditions.

Condition Evaluation Method

Set how display conditions are evaluated:

• Evaluate conditions on the first load - Evaluate conditions only when the page first loads. This option does not dynamically show or hide relevant widgets when a user makes a selection; refreshing the page is required.

• Continuously evaluate (default) - Continuously evaluate conditions as the user views and interacts with the interface. Use this option to enable the interface to dynamically show or hide relevant widgets based on user input.

Select whether to display the widget as a quick navigation tab. When this option is set to Yes, this widget and all those below it will display on a single tab until the next widget that's configured to display as the quick navigation tab. Additionally, you can set the quick navigation menu label override and edit the label icon.

Select whether to hide the widget background, displaying the buttons as stand-alone elements on the main interface background.

Configure actions above the Rich Text widget.

Show actions as a menu

Select whether to display available actions as buttons (default) or in a menu in the upper right corner of the widget.

User alternative colors for button

Select whether to show the default color scheme for the button (determined at the interface level in theme settings) or the alternative colors—generally a light/dark inversion intended to display better on dark backgrounds.

Select actions to include

Select the module actions to include above the Rich Text widget.

To edit an action label, remove an action, or configure button states to determine when buttons display, select the three dots icon, . Additionally, you can hover over the action tile and select the up and down arrows to rearrange the actions on the widget

For the Rich Text widget, we recommend you always select Preview in the upper right of the interface builder. While markdown and other formatting are automatically converted to display as they will to end users, it's still important to confirm the content displays properly.

Below is an example of some text created with markdown and the rich text toolbar, and the resulting widget in Preview mode.

Note that you must select Save in the Rich Text widget in the interface builder for your changes to display in Preview mode.

In the interface builder:

In the interface preview:

Use the Rich Text widget to display formatted text and dynamic data to end users.