Embedded Confluence report | Colined Help Center

This article explains why and how to embed reports in Confluence using an iframe macro.

Why should you embed a report?

By embedding report within a page, your team can visualize the contents of a Jira Cloud instance without leaving a Confluence space and without needing

These reports provide additional information beyond those available through Jira’s Reports template or Jira Charts Macro, by being sharable and highly interactive through the use of Slices and customizable tabs. As a result, these Slices allow you to filter and differentiate the contribution of each dataset, while using sequential tabs to add depth to each step of your analysis.

How can you embed a report within an iframe Macro?

Start by navigating to your Jira instance and creating your report. Customize it as needed, then save it. If modifying another user’s report, save your changes as a copy.

Follow these steps to embed a saved report into a Confluence page by using the iframe Macro.

Click the dropdown menu, and select Embed.

A pop-up will confirm that the embed link has been copied to your clipboard. The link appears as:

https://YOUR_JIRA_INSTANCE_NAME.atlassian.net/plugins/servlet/ac/biz.epicreport.epicreports/embed-report?report=YOUR_REPORT_ID

Open the Confluence page where you want to embed the report.
Click Edit.

Type /iframe to insert the macro quickly.

Alternatively, place your cursor where the report should appear. In the toolbar, click the + button and search for iframe.

Configure the iframe macro:

Paste the embed URL of your report.
Set the width (in % or px, e.g., 100% for full width).
Set the height (in px, e.g., 1000px).

Adjust optional settings such as frame border and scrolling.
Save the page and share it with your team.

You need View permission to access content in the Confluence space. To edit existing pages, you also need the required Add page permission for that space.

If the page is restricted from editing, refer to the related article and contact a Space admin or Confluence admin.

FAQ

What Jira permissions do you need to access the embedded report?

Jira permissions

Permissions set for the Confluence space are independent of those set for the report in Jira. The required permissions are as follows:

A user must have access to the Confluence space where the report is embedded using an iframe macro.
A user must have access to Jira and permission to open the report.
A user must have access to the report source, such as the Jira space where the work items are located or the saved filter used to create the report.

To review your access to a report source, refer to the related article.

For example, a user (such as a client) or a group of users may not have permission to view a report in Jira but may still have access to the Confluence page where it is embedded.

In this case, they will see the error message shown above for the embedded report.

App-level permissions

In addition to the required permissions listed above, users or groups must also have access to the app. The steps to restrict or restore access are described in a related article.

How can you filter an embedded report using slices?

When you select a slice before saving a report, that slice becomes the active slice for the embedded report.

For example, users can still switch to other slices while viewing a Confluence page. However, when this page is reloaded or opened again later, the originally selected slice is displayed.

As a result, when users open the Confluence page containing the embedded report, the selected slice appears active by default.

Can you edit the report within Confluence?

No. You cannot edit the report directly within Confluence.

A report embedded in an iframe Macro remains actively synchronized. Any changes to the report’s configuration in Jira will automatically reflect across all Confluence pages and spaces where the report is embedded.

Can you embed gadgets within Confluence?

No. You cannot currently embed Pivot Report gadgets directly within a Confluence page.

If your organization requires this feature, contact our support team to submit a request.

As a temporary workaround, you can embed a Jira dashboard that contains those gadgets within a Confluence page by using an iframe macro.

Troubleshooting

Can you lose access to a confluence space or page?

Yes. The error shown in the screenshot above may appear if you lose access to a Confluence space or page.

To restore access, contact a Space or Confluence admin responsible for managing permissions for that space.

Can you lose access to a report?

Yes. The error shown in the screenshot above may appear in a Confluence page if you lose access to a report.

To restore access:

Refer to the related article explaining how to restore access to public reports.
If the report is not shared publicly in Jira, contact the report owner or an administrator. They can update the report’s sharing settings, as described in a separate article.

What are the most frequent causes for a malfunction for an embedded report?

If the report does not display correctly in the page, please check the following:

Ensure that the URL is correct, see Step 4 from How can a report be embedded within an iframe Macro? above.
Verify that the embedded report is set to a Public sharing type, to enable all users and users groups to access it. If the report is set to Limited or Private only select users or users groups will be able to view it.
Verify the Confluence users or user groups are restricted from using Pivot Reports at the app-level.
Verify that the iframe Macro is properly configured with the appropriate width and height, see Steps 3 and 4 from Part 3.
Ensure that users are logged-in while viewing reports.

If you have questions or need assistance, contact our support team via email or service desk. Our team is available 24/7 to help with technical challenges or discuss improvements.

Can you embed a report in an external Cloud?

No. The error shown in the screenshot above may appear in a Confluence page when another user views a report embedded from a different Cloud instance.

For example, a report created in a Jira instance hosted on https://YOUR_JIRA_INSTANCE_NAME.atlassian.net cannot be embedded in an iframe macro within a Confluence page hosted on: https://OTHER_JIRA_INSTANCE.atlassian.net

To embed reports successfully, Jira and Confluence must belong to the same Atlassian Cloud environment.

Can a signed-out user access an embedded report?

No. A signed-out user cannot access an embedded report.

Colined protects your data by not storing it on its servers and by blocking access to the app for signed-out users.

If you are signed out of Jira, you cannot edit reports or use the app’s features, such as the report or calendar list. You can only access exported reports, including Excel files, HTML snapshots, and PDFs.

You also cannot view embedded reports. Even if a Confluence space allows anonymous access, embedded reports display an error message until you sign in to Jira.

How can you tell if you’re logged out of Jira?

You can tell if you’re logged out of Jira by checking whether:

An arrow pointing right is shown the top navigation bar.

Spaces, Filters, or Dashboards load as blank pages.

These signs indicate your account is signed out.

Click the arrow or the Try logging in link to log back into your Jira account.

Can you account be logged out due to inactivity?

Yes. Your organization may set an idle session duration, which logs you out automatically after a period of inactivity, as explained in a related Atlassian article.

Also, check your browser’s site data settings, since closing the browser often signs users out.

Will Jira notify you before logging you out?

By default, Jira does not show a warning before ending your session. To change this behavior, see the related Atlassian article.

If you have questions or need assistance, contact our support team via email or service desk. Our team is available Monday through Friday (9:00 AM to 7:00 PM GMT+7) to help with technical challenges or discuss improvements.