ÃÛ¶¹ÊÓƵ

Creating custom widgets for dashboards

In ÃÛ¶¹ÊÓƵ Experience Platform, you can view and interact with your organization’s data using multiple dashboards. You can also update certain dashboards by adding new widgets to your dashboard view. In addition to the standard widgets provided by ÃÛ¶¹ÊÓƵ, you can also create custom widgets and share them throughout your organization.

This guide provides step-by-step instructions for creating and adding custom widgets to the Profiles, Segments, and Destinations dashboards in the Platform UI.

NOTE
Any updates made to the dashboards are per organization and by sandbox.

To learn more about standard widgets, please refer to the guide for adding standard widgets to your dashboards.

Widget library widget-library

This guide requires access to the Widget library within Experience Platform. To learn more about the widget library, and how to access it within the UI, please begin by reading the widget library overview.

Getting started with custom widgets

Within the widget library, the Custom tab enables you to create widgets and share them with other users in your organization in order to customize the look of your dashboards.

IMPORTANT
Your organization can create a maximum of 20 custom widgets in the widget library.

Select the Custom tab to begin creating custom widgets or to view custom widgets that your organization has already created.

The widget library workspace with the Custom tab highlighted.

Create a custom widget

To create a custom widget, select Create widget from the top-right corner of the widget library or, if this is your organization’s first custom widget, select Create from the center of the widget library.

The Custom tab of the widget library workspace with Create highlighted.

In the Create widget dialog, provide a title and description for your new widget and choose the attribute that you want the widget to display.

NOTE
The list of available attributes depends on the schema that has been configured for your organization. To learn more about attribute selection and schema configuration, read the guide on editing the schema to create custom widgets.

To choose an attribute, select the radio button beside the attribute you want to add.

NOTE
Only one attribute can be selected per widget and only one widget can be created per attribute. If a widget has already been created for an attribute, the attribute appears grayed out.

The create widget dialog.

Select a visualization

After selecting an attribute, a preview of the new widget appears in the dialog. Artificial intelligence is used to automatically select a visualization that best fits the attribute data, and to provide additional visualization options that you can select manually.

Depending on the attribute, the AI recommends different visualization options. The complete list of visualizations includes:

  • Horizontal bar chart: Horizontal lines are used to represent values.
  • Vertical bar chart: Vertical lines are used to represent values.
  • Donut chart: Similar to a pie chart, values are shown as parts or pieces of a whole.
  • Scatterplot: Uses a horizontal and vertical axis to indicate values.
  • Line chart: Values are displayed using a single line to show changes over a period of time.
  • Number card: Displays a summary number to represent a single key value.
  • Data table: Values are displayed as rows in a table.
NOTE
The only metric currently supported for all attributes is profile count.
Data shown in the example widget is for illustration purposes only. The preview does not display actual data from your organization.

To save your new widget and return to the Custom tab, select Create.

The create widget dialog with the visualization options and Create highlighted.

Your new widget is now available to be added to a dashboard by choosing the widget from the library and selecting Add widget.

The Custom tab of the widget library workspace with the new widget and Add widget highlighted.

Hide a custom widget

After a widget has been added to the library, it can be hidden by selecting the ellipses (...) on the widget card and then selecting Hide widget. You can also preview and edit the widget from the same dropdown.

To view widgets that have been hidden, select Show hidden widgets from the top right corner of the widget library.

WARNING
Hiding a widget in the library does not remove the widget from the dashboards of individual users. If a widget should no longer be used in your organization, please ensure that you communicate this directly to all Platform users as they will need to remove the widget from their dashboards.

The Custom tab of the widget library workspace with the widget dropdown menu options and Show hidden widgets highlighted.

Edit a custom widget

You can edit custom widgets in the widget library by selecting the ellipses (...) on the widget card and then selecting Edit from the dropdown menu.

The widget dropdown menu options with the ellipses and Edit highlighted.

On the Edit widget dialog, you can edit the title and description of the widget, as well as preview and select different visualizations. After your edits have been made, select Save to save your changes and return to the custom widgets tab.

WARNING
Editing a widget in the library does not update the widget for individual users. If a widget has been updated, please ensure that you communicate this directly to all Platform users as they will need to remove the outdated widget from their dashboards and then select and add the updated widget from the widget library.

The Edit widget dialog.

Next steps

After reading this document, you are able to access the widget library and use it to create and add custom widgets for your organization. To modify the size and location of widgets that appear in the dashboard, please refer to the modify dashboards guide.

recommendation-more-help
ececc77d-ff44-4382-85ee-a087c8834323