Document toolboxDocument toolbox

Cloud: Authorize Custom Charts for Confluence

Why Do I Need to Authorize Custom Charts for Confluence?

  • Jira Cloud and Confluence Cloud are two separate applications

  • When you install Custom Jira Charts for Confluence on your Confluence Cloud instance, the app does not automatically view your Jira data. This is an important security restriction that Atlassian enforces to ensure that only apps you authorize can view your Jira data

  • Custom Jira Charts for Confluence is a charting app that displays Jira issues on Confluence pages, so you need to authorize it to view your Jira data

Steps to Authorize

The steps below must be completed one time by each user in order to authenticate the usage of Custom Charts for Confluence

  1. After you’ve installed Custom Charts for Confluence, navigate to a Confluence page

  2. Edit the page, then click + in the page header (Insert) to access the macro menu

  3. In the macro menu search bar, type in Custom Charts, then click Custom Jira Charts

  4. Once the editor loads, you will see the message below. Click Load Chart

  5. In the new page that opens up, choose the Jira site you want to pull in data from in the dropdown (if you have only one Jira site, you do not need to select anything)

  6. Click Accept and close out the authorization page once you see a confirmation message

  7. Refresh your Confluence page and you’re all set to use our macros!

 

Steps to Remove Authorization

If you uninstall Custom Charts for Confluence, the authorization will automatically be removed.

You must be a site admin to remove app authorization from Confluence

  1. Navigate to this link: https://id.atlassian.com/manage-profile/apps

  2. Find the Custom Charts app on the page, and click Remove Access

  3. Click Remove again in the pop-up menu

See Users that have Authorized Custom Charts for Confluence

  1. Navigate to this link: https://admin.atlassian.com/

  2. Click Products in the header bar

  3. In the grey panel on the left, under Sites and Products, click the site you need to see authorized users for

  4. Under Site Settings on the left, click Connected apps

  5. Find the app Custom Jira Charts for Confluence that, in the Installed by column, shows User. On the far right, click the set of 3 dots → View app details

  6. On this page, click the Authorization tab. A list of authorized users can be found at the bottom of the page

    1. If you’d like to revoke a user’s authorization, click Revoke next to their username

 


 

 

Authorization FAQs

Does each user need to authorize the app?

Does the app need to be authorized for each macro (Custom Charts, Issue List, and Simple Search)?

Does each user need to authorize the app?

Does the app need to be authorized for each macro (Custom Charts, Issue List, and Simple Search)?

Yes, but only the first time they use any of the Custom Charts macros (Custom Charts, Issue List, Simple Search).

No. Once you authorize it on one of our macros, it will be authorized for the rest of them as well.

Once a user authorizes Custom Charts, can I revoke their individual authorization?

If I uninstall the app, do I also need to take steps to remove authorization?

Yes! Learn more here.

No. If you uninstall Custom Charts for Confluence, it automatically removes the authorization.