Skip to content
D
Documentation

Dashboard widget catalog

concept
7 min readUpdated

Use this page to identify a Dashboard card or chart by its displayed title, find its grouped catalog and component family, and add it to the active tab when editing is available.

Dashboard widget catalogs

A Dashboard widget catalog is a grouped way to identify the cards and charts that can appear on your Dashboard. The Dashboard is a set of role-based tabs, and the gallery contains 109 dashboard components grouped by component family. The three catalogs map sibling widgets to a family rather than giving each widget its own page.

If you need to…Go to
Understand the role-based Dashboard tabsDashboard overview
Find a card or chart by its displayed titleFind and inspect a widget
Choose between the three grouped catalogsChoose a widget catalog
Add a selected widget to the active tabAdd a widget and save the tab
Review sales and backlog widget detailsSales and backlog widgets
Review pipeline and status widget detailsPipeline and status widgets
Review management report widget detailsManagement report widgets
Change administrative dashboard availabilityDashboard settings

The catalog helps you identify a card or chart by the title displayed for that widget. After you choose the family, use the widget picker to search the title and inspect its description where one is available.

Before you start

The Dashboard library is the widget-selection surface inside the Dashboard. It appears only when the Dashboard is on the custom-dashboard page and has at least one Dashboard tab. The picker is inside the dashboard surface used when the subscription-upgrade surface is not shown.

Prerequisites

  • Your role has a Dashboard.
  • The Dashboard has at least one tab.
  • You are in edit mode when you need to add, remove, or save widgets.

The edit header controls Widget and Save appear when edit mode is true. If the role has no Dashboard, the page displays Your role has no dashboard.

Open the Dashboard

Open the Dashboard to inspect its current cards and charts and, when editing is available, open the widget picker.

Prerequisites

  • You are signed in.
  • Your role has a Dashboard.

Steps

  1. Open the Dashboard by using one of these entry methods:

    Entry methodAction
    Application menuOpen Dashboard.
    Direct addressOpen /dashboard.
  2. Look for the Dashboard tabs and the edit header.

    The library surface appears when the Dashboard is on the custom-dashboard page and has at least one tab. If the page does not provide those tabs, use the Dashboard surface that is available to your role.

    The Dashboard surface and its available controls

Result: A Dashboard route is open, and you can see whether the role exposes tabs and the edit controls needed for widget work. Choose a catalog next.

Choose a widget catalog

The three catalogs answer different questions about the card or chart you want to find. Choose the catalog whose component-family group matches the business result you need.

If you need to find…ChooseComponent families
Sales, bookings, backlog, teams, branches, or due datesSales and backlog widgetsBacklog (10), Booking (8), Sales (5), Teams (4), Branch (3), Due-date (3)
Pipeline stages, accounts, bids, forecasts, orders, or visitsPipeline and status widgetsStatus (3), Account (2), Bid (2), Forecast (2), Order (2), Visit (2)
Top results, MRM, aging, bonus, or other management viewsManagement report widgetsTop-N (26), Cash and MRM (23), Aging (1), Bonus (1), Other dashboard widgets (12)

Catalogs group siblings by component family. They do not create a page for each widget. Use the focused catalog page when you need the detailed inventory for a family.

Find and inspect a widget

The widget picker is the list used to identify a card or chart before you select it. Search by title, then use the image, title, and available description to distinguish similar rows.

Prerequisites

  • The Dashboard is open in edit mode.
  • The widget picker is available.

Steps

  1. Open the widget picker from the Dashboard's Widget control.

  2. Enter a title or keyword in Keyword to search....

  3. Select Search for widget to filter the widget list by title.

  4. Review the matching row's Thumbnail image, title, and description.

    What you can inspectHow it helps identify the widget
    ThumbnailShows the visible image column for the row.
    titleIs searchable and filterable.
    descriptionIs filterable and appears with the title when present.
    Internal chart identifierRemains hidden unless export is requested.
  5. Use the picker selection controls as needed:

    If you need to…Select or clear…
    Select every widget-picker rowSelect all
    Return to the unfiltered listThe search field

Use the displayed title as the reader-facing identifier when the full widget list or change-widget flow shows similar rows.

Result: The widget list is filtered to the title match, and you can inspect the thumbnail, title, and available description before selecting a row. When you have identified the widget, add it to the active tab.

Add a widget and save the tab

Adding a widget changes the selected cards and charts for the active Dashboard tab. Saving commits that arrangement to the Dashboard.

Prerequisites

  • The Dashboard is open in edit mode.
  • You know which catalog and widget title to select.
  • You know the tab name to use when a new tab is required.

Steps

  1. Select Widget to open the add-widget flow.

  2. Choose the catalog and component-family group that contains the widget.

  3. Search for the widget title in Keyword to search....

  4. Select the matching widget row.

  5. Enter the tab title in New Tab when the add-widget flow requires a new tab.

    New Tab is a required text field.

  6. Select Save to save the Dashboard changes.

  7. Confirm that the selected card or chart appears on the active tab.

    A successful request displays Your request was completed successfully.

    If the request fails, it displays An error occurred while processing your request. Review the selected catalog, widget, and Dashboard conditions before trying again.

    If New Tab is empty, the form displays This Field Is Required instead of completing the tab operation. Enter the tab title and save again.

Result: The selected card or chart is added to the active tab, and a successful save displays Your request was completed successfully. If the catalog or widget surface differs, use the availability branches next.

Handle catalog availability branches

The catalog and its widget surfaces depend on the Dashboard state, subscription, available data, and edit mode. Use the visible surface to choose the next action instead of treating every missing widget as a search problem.

If you see…What it meansWhat to do
An existing widget menuWidgets exist and edit mode is on.Use the menu for the selected widget.
Remove widget from tabThe selected widget can enter the removal flow.Select it to start removal.
The removal confirmationThe selected widget is about to be excluded from the active tab.Read You are about to exclude this widget from this tab. Are you sure? before confirming the removal.
A different MRM widget surfaceThe MRM branch is selected by the widget's chart identity.Continue only when the subscription, data, and edit conditions for that branch are available.
Different principal-report columnsThe selected columns depend on the runtime tier.Use the columns available in the current principal report.

MRM widget branches are separately guarded by subscription, data, and edit conditions. A widget can therefore be in the catalog while its dashboard surface is unavailable in the current state. When the catalog does not provide the widget you need, use the troubleshooting table next.

When the catalog does not show what you need

Use the visible picker rows and titles to decide whether the widget is available in the current Dashboard. Search again with a shorter title or keyword when the first search does not identify the widget.

What you seeWhat to do
No pickerCheck that the role has a Dashboard, the page is the custom-dashboard surface, and at least one Dashboard tab exists.
No widget rowSearch again with a shorter title or keyword.
No descriptionUse the displayed title and thumbnail to identify the row.
No visible column captionWork from the row's displayed title, thumbnail, and available description.
A role or plan has a different row setTreat the available rows as role- and plan-dependent.

The message Please choose one or more principals belongs to the Principal report. If it appears, continue the Principal report flow and choose one or more principals there.

Use the tabs, rows, titles, descriptions, and selection controls that are visible in your Dashboard. Search again with a shorter title or keyword.

Continue from the catalog

The catalog identifies a widget; it is not a page for an individual widget. Each row names its widget and pairs a description where one is available.

After identifying the widget, continue to the relevant focused catalog page: Sales and backlog widgets, Pipeline and status widgets, or Management report widgets. Use Dashboard overview when you need the broader role-based tab view. Selected chart records can open sales or invoice records in a new tab.

Was this page helpful?

Need help using the product?

Dashboard widget catalog — PAMS Fresh Generation