Documentation Embedding FAQs

Embedding in Confluence

You can now embed Chartio dashboards into Atlassian Confluence! Unlike the typical Embedding functionality, which doesn’t require viewers to have a Chartio license, each user viewing the embedded dashboard in Confluence must have Chartio access. The Chartio dashboard is embedded as an IFrame that you can add to a Confluence page.

To get started, you’ll need:

  • Chartio access
  • Chartio Interactive Embedding enabled
  • Confluence access

Step 1 - Create your Chartio dashboard

In Chartio, create the dashboard you plan to embed. You can add Dashboard Controls to your embedded dashboard to enable users to filter the data. You can also use the Current User Variable to customize the viewing experience of each user.

Note: Viewers must be logged into Chartio to view any embedded dashboards; otherwise, they’ll receive the “Not Logged In” error message.

Step 2 - Embed your dashboard in Confluence

  1. In Confluence, navigate to the page you want to add the dashboard to and open the “Edit” view. Insert an IFrame macro onto your page by going to Insert > View More > Iframe.

    Confluence navigation

  2. To add your Chartio dashboard to the IFrame, you can paste in the following for your URL, adjusting it so it contains your org slug and dashboard slug (make sure to remove the curly braces!):

    https://chartio.com/d/{your-org-slug}/{your-dashboard-slug}/?embed=1

    Include any Dashboard Controls after ?embed=1 to filter the query, where each Control is separated by an &. For example, if we wanted the PLAN Dropdown to show Premium by default in our embedded dashboard, we’d include our PLAN Dropdown in the URL like this:

     https://chartio.com/d/my-org/my-dash/?embed=1&PLAN=Premium
    

    iFrame Chartio dashboard

  3. You can optionally adjust the width and height to accommodate the size of your dashboard.
  4. Once you’re done editing your IFrame, click Insert. (If you’re editing an existing IFrame, click Save.)
  5. Publish your Confluence page so you and the other page viewers can see your embedded Chartio dashboard!

    Embedded Chartio dashboard

Troubleshooting

“Not Logged In” message

Confluence users must be logged into Chartio to view the embedded dashboard. If they’re not logged in, they’ll get a message directing them to the Chartio login page, as seen below:

Not Logged In error message

Upon seeing the message, the user can click Open Login Page to open Chartio in a separate tab and enter their username and password. Once they’re logged into Chartio, they can simply reload the Confluence page and the embedded dashboard will display.

Controls not working

If the Controls on your embedded dashboard aren’t responsive to mouse clicks, you’ll need to enable the Allow Viewers to Apply Dashboard Variables checkbox on the dashboard’s Embedding page.

Testing sandbox

To access your dashboard’s Embedding page, open your dashboard settings and click Embed in the top-right corner.

Embed option in chartio