Get Started with BrightGauge Essentials

This page applies to: BrightGauge Essentials Pilot


This document provides an introduction to BrightGauge Essentials. Essentials is a slimmed-down version of BrightGauge that provides dashboards and reporting for up to three datasources. If you're new to BrightGauge, you can learn more about how BrightGauge works here.

Note: Currently, Essentials is only available for ConnectWise Manage Cloud partners. However, Essentials will be rolled out to all ConnectWise products in future releases.

This article covers the following topics:

BrightGauge Essentials Users

Essentials includes two user types:

  • BrightGauge Admins have full access to the Essentials account. Each Essentials account includes one admin user.
  • BrightGauge Viewers may only view and present dashboards. Each Essentials account includes an unlimited number of viewers.

The following table lists the features available to admin and viewer users in Essentials.

Feature Admin Viewer
View dashboards
Present dashboards
Apply dashboard filters  
Create dashboard filters  
Send reports  
Add viewer users  


Create BrightGauge Roles in Home

Before you log in to Essentials:

  • Enable ConnectWise SSO.
  • Create and assign the BrightGauge Admin and BrightGauge Viewer roles in ConnectWise Home. 

For more information on ConnectWise Home and SSO, please refer to Getting Started with ConnectWise Home and Single Sign-On.

To create the BrightGauge roles in Home:

  1. Log in to ConnectWise Home.
  2. Navigate to the ConnectWise Home > User & Application Settings > Roles tab.
  3. Click ADD A NEW ROLE.


  4. Enter BrightGauge Admin into the Name field.
  5. Add a Description for the role.
  6. Select the Users List tab.


  7. Select your designated admin user.
  8. Click Save.
  9. From the User & Application Settings > Roles tab, click ADD A NEW ROLE.
  10. Enter BrightGauge Viewer into the Name field.
  11. Add a Description for the role.
  12. Select the Users List tab.
  13. Select the users to which you want to add the BrightGauge Viewer role. You can also add users after the role has been created.
  14. Click Save.

Assign User Roles from Home

Designate who in your company will be the admin for the account and assign them the BrightGauge Admin role. All other users are viewer users assigned the BrightGauge Viewer role. Only users assigned a role in Home may log in to Essentials. If you must add additional viewer users, you may do so at any time from ConnectWise Home. Assigned user roles can be updated for multiple users at once.

To assign a role from Home:

  1. Log in to ConnectWise Home.
  2. Navigate to the ConnectWise Home > User & Application Settings > Users tab.
  3. Select the checkbox of the appropriate user(s).
  4. Select User Settings > Permissions > User Roles.
  5. Select either Add Role or Remove Role, based on the desired action.
  6. Select the role to add or remove.
  7. Click Apply to save the update.

Log In to Essentials

Access your BrightGauge account from ConnectWise Home.

To log in to BrightGauge:

  1. Log in to ConnectWise Home.
  2. Hover over the BrightGauge tile in My ConnectWise Hub and click Launch. BrightGauge opens in a new browser tab.

After login, Admins are brought to the BrightGauge home page. Viewers are brought to the Dashboards screen. By default, Viewers cannot see dashboards until they are shared by the Admin.


Connect a Datasource

Datasources provide the data for your dashboards and reports. Before your dashboards and reports can display data, you must connect a datasource to your BrightGauge account. Only admin users can add datasources. To access your datasources, select DataDatasources from the top menu bar.

Note: More datasources will be added as Essentials is made available for other ConnectWise solutions.

For instructions on adding a datasource, please refer to the following article:

Dashboards and reports are added to your account after the datasource is saved. The initial sync usually takes 20-30 minutes to complete. Please note that dashboard and report gauges only pull data for the last 30 days. To include data beyond 30 days, apply filters to your dashboards and reports.


Share a Dashboard with a Viewer

Viewers cannot see dashboards until they are shared by the admin.

To share a dashboard:

  1. Click Dashboards in the top menu bar.
  2. Select the dashboard you would like to share.


  3. Select More > Dashboard Users.


  4. Select the checkbox for each viewer who should have access to the dashboard.
  5. Click Apply.

Alternatively, you can share dashboards from your account settings:

  1. Navigate to Your AccountViewers.


  2. Click on the Edit icon_viewer_edit.png icon for the desired viewer.
  3. Select the checkbox for each dashboard you would like the viewer to access.
  4. Click Save.


Present a Dashboard

Presentation mode optimizes dashboards for display on TVs and monitors. For example, you can display a ticketing dashboard on a TV mounted on a wall in the technician area of your office or display a sales dashboard in your sales bullpen. Both admin and viewer users can present dashboards.

Two options are available when presenting a dashboard:

  • Present a single dashboard
  • Present multiple dashboards

The multiple dashboard option enables you to create a rotating playlist of up to 10 dashboards.


Present a Single Dashboard

To present a single dashboard:

  1. Locate the dashboard you would like to present.


  2. Click Present and select Single Dashboard. The dashboard switches to presentation mode.


  3. To exit presentation mode, click the TV icon_present_exit.png icon in the upper-right corner of the dashboard. You are returned to the Dashboards screen.


Present Multiple Dashboards

To present multiple dashboards:

  1. Click Dashboards in the top navigation bar.
  2. Select a dashboard you would like to present.


  3. Click Present and select Rotate Dashboards.


  4. Click and drag dashboards from the Your Dashboards column into the Playlist column.
  5. Click Save & Present.


Change a Dashboard Color Theme

Dashboards can be presented with either a light or a dark color theme. To change a dashboard's color theme, click the paintbrush icon_present_changetheme.png icon in the upper-right corner of the dashboard. Then, select a color theme.


Filter a Dashboard

Dashboard filters enable you to quickly sort and view specific information on a dashboard. For example, you have a technician dashboard that displays ticket information for all your technicians. You can create a filter for each technician so you can quickly view individual data for each technician from the same dashboard.

To apply a dashboard filter:

  1. Locate the dashboard you would like to filter.
  2. Click Add A Filter. The Add Filter window appears.


  3. Enter a name for the filter.
  4. Select which field(s) to include in the filter. The Add Filter window allows you to search for fields and displays a list of available fields sorted by dataset. To search for a field, type the field name into the Which fields do you want to filter? box. A list of fields matching the search is displayed. Select the checkbox for each field you want to include. Be sure to select the relevant field from each dataset.


  5. After you select your field(s), select an operator and enter your criteria. Please note that the available operators are dependent on the field type (text, number, date, etc.) you select.
  6. Click Save Changes to apply the filter.

To disable a dashboard filter, click Active Filter, then click the toggle next to the filter name.


Quick Tips for Dashboard Filters

  • Only Admin users have access to create, edit, and delete filters. Viewer users may only toggle filters on and off.
  • Any dashboard filters left toggled on or off are preserved the next time you view that dashboard. Viewer filters are not preserved and revert back to how the Admin has them set.
  • When multiple dashboard filters are applied at once, only the overlapping data is displayed. For example, if you have two separate technician filters toggled on, you may only see the tickets they have both submitted work for.

Send a Report

Reports allow you to share snapshots of important metrics with internal team members. Please note that reports can only be sent by admins and only to other users within the account. Reports cannot be sent externally and cannot be scheduled in advance.

To send a report:

  1. Select Reports from the top menu bar.


  2. Click the three dots icon for the report you would like to send and select Create Report.


  3. The For My Company option is selected by default. Click Next Step.
  4. The report template is automatically selected. Click Next Step.
  5. Edit the report title and subtitle as desired. Please note that report gauges cannot be added to, removed from, or modified within the report.
  6. Click Next Step.
  7. Click into the To field to select the desired report recipient(s). The report can only be sent internally to users within your Essentials account.
  8. Modify the email subject and message as needed.
  9. Click Send Report. The report is sent as a weblink to the selected recipients.

Default Resources

The following dashboards and reports are included in Essentials. Please note that data sync once every 24 hours. Data cannot be manually synced within Essentials.


  • Essentials Dashboard | Financials
  • Essentials Dashboard | Operations
  • Essentials Dashboard | Service & Revenue


  • Essentials Report | Financials
  • Essentials Report | Operations
  • Essentials Report | Service & Revenue


Upgrade Your Account

You can upgrade your account at any time from within BrightGauge. For more information on what's included in each plan, please refer to BrightGauge Plan Feature Comparison.

To upgrade your account:

  1. Navigate to Your AccountBilling.
  2. Click Upgrade.
  3. Edit your location settings, timezone, and language, if needed.
  4. Click Next Step.
  5. Enter your name and payment information, then click Add Card.
  6. Click Change Plan.
  7. Select a plan from the list. The numbers default admins and datasources are displayed. Click the plus and minus signs to add or remove users and datasources as needed. Note how changes are reflected in the monthly price.
  8. Click Complete Upgrade.


Was this article helpful?
0 out of 0 found this helpful