101 - Client Reporting


Regular reporting is something that every MSP should be doing to keep up relations with their clients. This document covers everything you need to know on how to create client reports in BrightGauge.  

Here are the steps for setting up client reports:

  1. Create client mappings telling BrightGauge how your customer's company name shows up across your connected datasources. This will help you be able to create one scheduled report, going out to multiple clients.
  2. Add your client recipients under client mappings. A report cannot be sent to a person not listed in your account. You may share with admins, analysts, viewers, and client recipients. 
  3. Click the green "+" at the top of your account, selecting for "Reports".
  4. Select for my customers and select all customer you would like to have receive that report. You may do the same if you want to create reports specific to a customer for you to share internally with your team.
  5. Customize.
  6. Schedule or send now. 

Step 1 - Set Up Client Mapping

The first step is to set up client mappings for each of the customers you plan on sending reports to.


This step teaches BrightGauge the names of your clients and their corresponding names in each of your datasources. 

Adding Client mapping
To add a new client click on click “Add a Client”

Use the auto mapping search bar

When the modal opens you can name the mapping and search for the client using the search input. This will search through your selected integration(s).


Mapping Results

If the search finds a match it will display the amount of results found in each datasource. Clicking the integration logo card will allow you see see the listed company mappings found under that datasource.
If the name doesn't match correctly you can remove it by clicking the "x" icon.


Single Datasource Search 

If the auto mapping search does not provide a result or an incorrect mapping click the "+" icon on the datasource row. In the search bar proceed to enter the name for this client EXACTLY as it appears in the corresponding datasource database. It will search again and you can select the appropriate one from the drop down list.

If a client has multiple names for the same datasource (bundling child accounts into a parent account or multiple sites into one account), you can use this method to combine all of them. 

Make sure to check the names across all datasources. If you are mapping multiple accounts into the same client, you’ll have to search in each datasource. 

Adding clients who aren't listed




Once a client mapping is created you can edit or delete it using the 3 ellipse (more options) menu on the right.

Step 2 - Client Recipients

The next step is to assign recipients (contacts) for this client. This is only needed in order to have reports emailed directly to them. Use the 3 ellipse (more options) menu on the right and click on "Client Recipients" to launch the modal.

Start by typing the client’s name or email address.  If you already have them as a recipient or contact in your account, then it will show those results. If you want to add a user that's not listed,  use the form below the user listing window. You can add as many recipients as you would like.


Step 3 - Create a Client Report

This article covers everything related to creating a report for team members. Below are the specifics on how to create a report for clients. 

To create a client report, click on the green "+" at the top of the page. Select "For My Client" and choose all the clients you'd like to send one report type to. 
  1. Select whether you’d like to “Start From Scratch”or “Start From a Template"
  2. Select gauges from the side panel. Use the search bar for faster sorting by gauge name or dataset name. You may rearrange and drag to resize these. You’ll notice that all gauges appear in reports, just as they do on dashboards, with the exception of number gauges to keep them in a readable format.
  3. You can choose to show gauges from one or multiple datasources. This is great for when you’re sending an executive summary and want to provide an overview of the overall health of a company.
  4. Apply filters to your gauges to include or exclude certain team member data, date ranges, and more. Click here for details on choosing the right filter.

  5. View a preview of what each client will see. 



Step 4 - Choose Recipients

Placing your cursor on the "To:" or "Cc:" section will expand a dropdown menu that will show all users and viewers you have created in BrightGauge. You can search for desired users by typing their name, or simply scroll through the users populated in the drop down list. 

When creating a client report, there will be a line for ‘All Client Recipients’ in the drop down list. Selecting this option will send the report to the associated Client Recipients for the selected clients. 


With regards to the "CC:" section, any user listed here will be copied on all report emails sent to those recipients specified in the "To:" field.(This includes "All Client Recipients".)

Step 5 - Schedule Report


Once you have set the desired schedule, click on the "Update Report" button to apply the settings.


Was this article helpful?
7 out of 8 found this helpful



  • Can clients download a CSV from a gauge as a viewer account?

  • Hi Zubriel,

    No they cannot. CSVs can only be downloaded in-app (gauge builder, dashboard, or report builder). This is because CSVs are emailed to a recipient and reports can be viewed by anyone without logging in, so no associated email.

  • Got ya. Thanks!