Brightspot CMS User Guide

Creating a custom site widget


This topic explains how to create a custom site widget in Brightspot.

Note
Custom site widgets override the standard widgets that all users see when editing a site. If you want to design a site widget for a particular role or role-site combination, contact your Brightspot representative.

To create a custom site widget:

  1. Click menu > Admin > Users & Roles. The Content Forms widget is displayed on the left side of the page.

    Custom Site Widget Create.png Custom Site Widget Create.png

  2. From the drop-down list, do one of the following:

    • Select Global to customize the Edit Global widget.
    • Select Site to customize the New Site and Edit Site widgets.
  3. Click New.

    Custom Site Widget Configure.png Custom Site Widget Configure.png

  4. In the Name field, type a name for the widget.
  5. From the Scope list, select Global. (This setting overrides the default site widget with the custom site widget.)
  6. From the Accesses list, select read or write access for all tabs and fields on the widget. (This setting applies to the entire widget; you can override this setting at the tab and field levels in the following steps.)
  7. Show, hide, and reorder items by doing the following:

    • Hide a visible tab by dragging it to the Hidden Items list. (Don’t hide tabs containing fields that are required in the default site widget.)
    • Show a hidden tab by dragging it to the Visible Items list.
    • Reorder the visible tabs by dragging them to the required position.
  8. To add a new tab to the widget, do the following:

    1. Under Visible Items, click add_circle_outline and select Tab.
    2. In the Name field, type a name for the tab.
    3. From the Access list, select one of the access options.
    4. Repeat steps a–c to add additional tabs.
  9. To customize a tab and its fields, do the following:

    1. Click the tab field to expand it.

      Custom Site Widget Tab.png Custom Site Widget Tab.png

    2. In the Name field, type a name for the tab.
    3. From the Access list, select one of the access options.
    4. To hide a visible field, drag it to the Hidden Items list. (Don’t hide a field that is required in the default site widget.)
    5. To show a hidden field, drag it to the Visible Items list.
    6. To reorder visible items, drag them to the required position.
    7. To change a field’s name or access level, do the following:

      1. Click the field.

        Custom Site Widget Inheritance.png Custom Site Widget Inheritance.png

      2. In the Name field, type a name for the field.
      3. From the Access list, select one of the access options.
    8. Group fields within the tab by doing the following:

      1. Under Clusters, click Add Group.

        Custom Site Widget Icons.png Custom Site Widget Icons.png

      2. In the Name field, type a name for the group.
      3. From the Access list, select one of the access options.
      4. From the Fields list, drag fields into the group and in the desired order.
  10. Click Save.

Brightspot saves the custom site widget, and the widget appears in the Content Forms widget. In addition, administrators use this widget when configuring the Global site or other sites.

Previous Topic
Custom site widgets
Next Topic
Modifying a custom site widget
Was this topic helpful?
Thanks for your feedback.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Modules
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Shopify
Apple News