Edit a Widget

Once you have created a custom widget, using either the Create or Duplicate method, you can edit the widget even after it has been added to a dashboard.

Note: When you edit a custom widget you can change anything about the widget except the widget template. If you need to use a different widget template, create a new widget that uses the desired template.
  1. Locate the widget you want to edit in your Widget Library. You can search for a widget by typing the widget name in the Search field, filter by category, or filter for all custom widgets by selecting Type > My Widgets.
  2. Select the More options button on the right side of the widget, and then select Edit to open the Edit a Widget page.
  3. From the Edit a Widget page, on the General step, you can edit the Widget Details as follows.
    • Widget Name: Enter a name for the Widget. This text appears as the title of the widget.
    • Widget Icon: Select an icon from the dropdown menu. If you want to filter for icons that conform to the Trimble Modus design system, select the Modus option.
    • Select Categories: Select all the categories from the widget library that apply to the widget, and then select Apply. Once applied, the widget will appear in those categories in your widget library.

    Note that the widget template cannot be changed.

  4. Select Next to continue to the Configuration step. Currently, neither of the available templates require configuration.
    Select Next again to continue to the Data Provider Details step. The following step varies based on the widget template you selected.
    • For the Link List template, continue to the next step.
    • For the Single Action template, continue to step 6.
  5. Data Provider Details: Link List. If you selected the Link List template, enter the following details.
    Header Options
    When configured, this section puts an add button in the upper right-hand corner of the widget that links to a URL. For example, the button could be linked to a page for creating a new form or report. This section is optional.

    • Widget Header Add Button URL: Enter the URL you want to use for the add button.

    Widget Links
    In this section, you can add links with associated icons that appear in the widget.
    • Link Text: Enter the text you want to display for the link.
    • URL: Enter the URL for the link.
    • Icon Type: You can select whether or not you want an icon to appear to the left of the link, and also select the icon.
      • No Icon: No icon appears for the link.
      • Standard Icon: Select or search from a list of icons. If you want to filter for icons that conform to the Trimble Modus design system, select the Modus option.
      • Custom Icon: Select to specify a URL to a hosted image that will appear next to the link.
      • Light Mode Icon URL: (For custom icons only) Enter the URL for a hosted image. This icon is used when light mode is enabled.
      • Dark Mode Icon URL: (For custom icons only) Enter the URL for a hosted image to be used for dark mode. If you don't specify an image in this field, the one indicated in the Light Mode Icon field will be used for dark mode as well.

        For information about switching between dark mode and light mode, see Dark Mode.

    • Add Additional Link: Select to add another link to the widget. You can also select Remove to remove a link

    Continue to step 7.

  6. Data Provider Details: Single Action: If you selected the Single Action template, under Widget Data, enter the following details.
    • Action Description: Enter a brief description of the action the widget will perform (for example, "Open SketchUp").
    • Button Display Text: Enter the text you want to appear on the button.
    • URL: Enter the URL that you want to open when the button is selected.
  7. Once you have configured the widget details, select Finish to close the Create a Widget page. From the dashboard, select Save.
    The widget is saved and available in your widget library.