Brightspot CMS User Guide

Tutorial: Configuring dashboards for your team



You are the head of a department that consists of writers, editors, analysts, etc. This team works on producing world-class content for a professional golf publication on a daily basis. As part of this content creation, you and your team need to be able to quickly find assets and get information without having to search for it in Brightspot.

During a team meeting, members of your staff say that while Brightspot contains a wealth of information regarding analytics, it can be time-consuming to dig down to find it. Another team member chimes in and says that as an editor, she loves Brightspot's search capabilities, but would love if there were a quicker way to find assets that need to be reviewed.

As the advanced user that you are, you know the easiest way to make this information available to your team is through the use of dashboards. You tell your team to give you a little time, and that you will develop a dashboard that will give them all the information that they need.

As such, in this tutorial, you will complete the following tasks:

  1. Create a team dashboard.
  2. Set the layout of the dashboard.
  3. Add widgets to the main tab.
  4. Add tabs to the dashboard that provide information specific to the roles on your team.
  5. Test the dashboard.
  6. Add this dashboard to the roles within Brightspot your team members occupy.
  7. Review the dashboard with your team, and make any changes they feel would help them even more.

This tutorial assumes the following:

  • You have access to the Admin area in Brightspot.
  • The writer, editor, and analyst roles have been set-up in Brightspot. See Creating a role and Assigning site specific roles for information on creating and assigning roles in your site.

In this step, you will create the base dashboard for your team. Later, you will add onto it in order to meet the needs of each of the roles on your team.

To create a dashboard:

  1. Click menu > Admin > Dashboards.
    By default, the New Dashboard page opens where you can create the new dashboard for your team.
  2. Enter the Name for this dashboard.
    Since you are creating a dashboard for your team, it makes sense to name it as such. For example, the Golf News dashboard.
  3. Enter the Main Tab Name for your dashboard.
    Since dashboards can have multiple tabs, each must be identifiable by a name. Perhaps you want your main tab to provide general information that each member of your team can use. In that case, you might name your main tab General Info.
    Dashboard tutorial main tab created.jpg Dashboard tutorial main tab created.jpg
    New dashboard with main tab created
  4. Click Save.

    You have now created your team dashboard, but it does not have any widgets to display. You will begin to build out this dashboard in the next step.


Now it is time to set the layout of the main tab. The layout determines how many columns the main tab will have. Once you set the columns, then you can add widgets to the columns to display information.

To set the layout for the main tab:

  1. In the Main Tab Columns field, click add_circle_outline Add Dashboard Column.

    When you add that first column, you see the number 100. This means this column spans 100% the width of your dashboard.

  2. We want our dashboard to have two columns, so click add_circle_outline Add Dashboard Column again.

    Notice how the numbers now say 50 to signify that each column covers 50% of the width of the dashboard.

    Tip
    Notice at the top of the columns is a bar with a slider in the middle. This slider allows you to set custom widths for the columns in your dashboard. Perhaps instead of 50% / 50% for your column widths, you would prefer 70% / 30%. Simply drag that slider toward the column that you want to be the smaller column. This automatically enlarges the other column and allows you to set them to your desired custom width.



    The columns stack in the order they are added. Therefore, the first column will be the left-most column, and so forth.

    Dashboard tutorial second column added.jpg Dashboard tutorial second column added.jpg
    Second column added to main tab

You have now set the layout of the main tab of your team dashboard to have two columns. Next, you will add the widgets to the column to display the information your team needs.


Now it is time to add the widgets to each column. The widgets are the items on the dashboard that actually display the information you desire.

  1. In the first column (the one at the top of the stack), click add_circle_outline in the Widgets field.
  2. Scroll through the list of available widgets and select the My Activity Widget. This widget allows each team member to see assets they are working on or have recently touched.
  3. By default, the title of this widget is My Activity, but you can change this if desired by adding a new Title.
  4. Repeat these steps for the first column, but this time select the Recent Activity widget.
  5. In the second column (the one at the bottom of the stack), click add_circle_outline in the Widgets field.
  6. Select the Unpublished Drafts widget.
    Dashboard tutorial widgets added to main tab.jpg Dashboard tutorial widgets added to main tab.jpg
    Widgets added to the main tab
  7. Click Save.

The General Info tab you added has widgets primarily designed to help your writers and editors. You can add multiple tabs to a dashboard to fulfill specialized needs. For example, you also have analysts on your team that need quick access to analytics data. Here you will add a second tab to the same dashboard you just created that will have widgets dedicated to the analysts on your team.

To add an additional tab to a dashboard:

  1. In the Additional Tabs field, click add_circle_outline Add Dashboard Tab.
  2. Enter a Name for this tab. Since it is going to be for your analysts, name it Analytics.
    Dashboards tutorial add tab fields.jpg Dashboards tutorial add tab fields.jpg
    Second tab added
  3. Click add_circle_outline Add Dashboard Column.
  4. Under Widgets, click add_circle_outline.
  5. Select the Report Widget.
  6. Configure your Report widget.
    1. Enter a Heading for your Report widget. This is the text that displays at the top of the widget.

      This first Report widget will display where your site traffic is coming from, so call it Traffic Source.

    2. Expand the Reporter field and select Line.

      This selection means your Report widget will have a chart showing a line with your traffic source breakdown.

    3. Expand the Supplier field and select Traffic Source.
    4. Expand the Channels field and select Search.

      The Channels field displays how a visitor arrived at your site.

    5. Expand the Period field and select Past Days.

      Past Days allows you to set how many days back you want to examine your traffic sources.

    6. Expand Time Zone and select your time zone, or the time zone for which you want to report.
    7. In the Amount field, enter the number of past days you want to look back to gather traffic source data.
      Enter 120.
      Dashboard tutorial reports widget.jpg Dashboard tutorial reports widget.jpg
      Reports widget fields completed
  7. Click Save.

The Report widget is a very powerful widget that allows you to customize reports specifically to show the data you are looking for. We have only scratched the surface of this widget in this exercise. See Configuring the Report widget for more information on using this widget.

Also, setting time intervals and time zones within a widget is extremely important and can drastically affect the results generated. See Understanding time intervals for analytics for detailed information.

Note
If you would like, add another Report widget to the column on your Analytics tab. Play around with the different settings to see what kind of data you can pull.

One thing to note is that if you do not see any data, it may mean your filtering criteria does not match any live data.


Now that you have your dashboard created, it is time to test it. This can be done easily via your profile and will not affect any other users.

To test your dashboard:

  1. Click your user name in the upper-right corner of Brightspot to open your user menu.
  2. Click Profile and then click CMS.

    This is the page where you can specify your personal preferences within the CMS.

    Dashboard tutorial cms tab .jpg Dashboard tutorial cms tab .jpg
    CMS tab on the user profile page

  3. Expand the Dashboard cluster.
  4. In the Dashboard field, take note of the name of your current dashboard (you will want to change back to this later), and then select Shared.
  5. Open the nested Dashboard field and select the Golf News dashboard you created.
  6. Click Save.
  7. Now click Brightspot in the upper-left corner of the page.
    This opens the Golf News dashboard you created. Check the widgets on your General Info tab and your Analytics tab to see if they look correct and are easy to use.
    Dashboard tutorial dashboard preview.jpg Dashboard tutorial dashboard preview.jpg
    New dashboard with two tabs
  8. To return to your regular dashboard, repeat steps 1–6 and replace the Golf News dashboard with the name of your regular dashboard.

All users within Brightspot are assigned a role. A role is a group of permissions that a user has access to. Your team has three roles: writer, editor, and analyst. In this step, you will assign the Golf News dashboard to these roles so they see this dashboard when they log into Brightspot.

To assign a dashboard to a role:

  1. Click menu > Admin > Users & Roles.
  2. Select your Writer role from the Roles widget in the left-navigation bar.
  3. Click Dashboard.
  4. In the Dashboard field, select Shared.
  5. In the nested Dashboard field, select Golf News. This is the dashboard you just created.
    Dashboard tutorial assign dashboard to role.jpg Dashboard tutorial assign dashboard to role.jpg
    Assigning a dashboard to a role
  6. Click Save.

    Now, all of your users who have the Writer role assigned to them will see the Golf Newsdashboard the next time they visit their dashboard page in Brightspot.


After your team members viewed the dashboard, they had some feedback that they felt would make the dashboard more useful to them. This can be easily done by modifying the dashboard.

The feedback you were given was that they would prefer to have the widgets reordered on the General Info tab, and the analysts thought a bar chart might be more useful instead of a line graph in the Reports widget.

To modify a dashboard:

  1. Click menu > Admin > Dashboards..
  2. Click Golf News in the Dashboards widget in the left-navigation bar.
  3. Under Main Tab Columns, click the first column cluster to view the widgets.

    Remember, the first column is the one listed at the top of the stack.

  4. Click the Recent Activity widget to highlight it, and then drag-and-drop it above the My Activity widget.
    Dashboard tutorial dragging widget.jpg Dashboard tutorial dragging widget.jpg
    Reordering the widgets by dragging and dropping
  5. Under Additional Tabs, expand the Dashboard Tab: Analytics cluster by clicking expand_more next to its name.
  6. Under Columns, expand the only column there is.
  7. Under Widgets, expand the Report Widget cluster.
  8. Under Reporter, select Bar Horizontal.
    Dashboard tutorial changing report widget.jpg Dashboard tutorial changing report widget.jpg
    Changing the Reporter field in the Report widget
  9. Click Save.

Now when your team members access this dashboard, the widgets on the General Info tab will be reordered as they desired, and the chart on the Analytics tab will now display as a bar graph.

Previous Topic
Applying shared dashboards
Next Topic
Configuring dashboard widgets
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