Embed BrightGauge KPIs (Dashboards & Gauges) in Hudu

You can surface BrightGauge KPI dashboards inside Hudu so technicians and stakeholders have live metrics alongside your documentation. The two easiest ways are:

• Embed a BrightGauge Public Dashboard URL or Public Gauge in a Hudu KB article, Process task, Quick Note, Asset embed field, or
• Use Hudu’s Magic Dash to keep important, embedded content front-and-center on a company's home page

Prerequisites

• BrightGauge User Role: You must be an Admin or Analyst in BrightGauge to generate Public Dashboard or Public Gauge links. Viewer users cannot generate public URLs but can click on links you provide.

• BrightGauge Plan:

  • Enterprise plan: Required for Public Dashboards and Public Gauges (embeddable via iframe).

  • Basic/Team plans: No public embed options are available. You can only link to reports (login required) or upload screenshots/exports into Hudu.

Embed a BrightGauge Public Dashboard (Enterprise Plans)

1. In BrightGauge, open the dashboard and select More → Public URL. Enable and copy the link.
2. In Hudu, open your article, process, or asset with an Embed field.
3. Paste the iframe code provided (example below).

4. Save & test: the dashboard should display and update automatically.

   
   <iframe
     src="YOUR_PUBLIC_URL"
     title="BrightGauge Dashboard"
     width="100%"
     height="600"
     frameborder="0"
     allowfullscreen>
   </iframe>

Alternatives if You Cannot Use Public Dashboards

• Public Gauges (Enterprise only): Like dashboards, individual gauges (KPIs) can be made public and embedded with an iframe.

• Reports: While reports cannot be embedded, you can paste a report’s URL into Hudu. Please note, anyone who clicks it will need to log in with their BrightGauge account to view it.

• Screenshots: If embedding isn’t possible, export a screenshot of a gauge or dashboard from BrightGauge and upload it into Hudu documentation.

Using Magic Dash to Display Dashboard or Gauge (API Required)

Magic Dash is an API-powered feature in Hudu that lets you create dynamic, customizable dashboard widgets within each Company/Client space. It does not support direct iframe embedding like a public URL paste-through; instead, you must push content via the API. Please see our article on Using the Magic Dash for more information.

• Generate the API key: Go to Admin → API Keys and create a key scoped to Magic Dash usage.
• Compose a Magic Dash item via API: Use Hudu’s REST API (accessible in the Admin area under API → View API Documentation) to send a POST request with a JSON payload that defines your Magic Dash widget. 

Here's an example of the JSON payload structure:

{
  "title": "BrightGauge Dashboard",
  "company_name": "AcmeCorp",
  "message": "Live KPIs from BrightGauge",
  "content": "<iframe src='YOUR_PUBLIC_URL' width='100%' height='300' frameborder='0' allowfullscreen></iframe>",
  "content_link": "",
  "icon": "fas fa-chart-line",
  "shade": "success"
}

You can choose to include the iframe HTML in the content field if you want the dashboard to appear directly inside the Magic Dash widget. Alternatively, you can use content_link to provide a clickable link that opens the public dashboard externally. Note: you cannot set both fields simultaneously. 

Once the request is sent and processed, the BrightGauge content will appear on the client’s Magic Dash and update automatically as long as the iframe points to a live, public BrightGauge URL.

Security & Access Notes

• Public Dashboards: Only available at the Enterprise level. They are read-only and can be disabled in BrightGauge at any time.
• Viewer accounts: If you cannot use Public Dashboards, share dashboards internally with Viewer accounts and link them in Hudu (requires authentication).
• Single KPI embeds: Embedding individual public gauges can be a lighter-weight alternative to full dashboards.

Troubleshooting

• Blank frame / refused to connect: Make sure you used a valid Public Dashboard or Public Gauge link. These features are only available on Enterprise plans. If you’re on a lower plan, BrightGauge won’t provide embeddable links.

• Data looks stale: Confirm the source dashboard or gauge is updating in BrightGauge. Embedded versions follow the same refresh cadence as BrightGauge itself.

• No Enterprise plan: You cannot embed live dashboards or gauges. Instead, link to reports (authentication required) or upload screenshots of gauges/dashboards into Hudu.