User Impersonation allows Confluence users (even those without a Jira license) to view Jira data in charts on a Confluence Page.

This feature is NOT ENABLED BY DEFAULT. It must be manually turned on by a Confluence admin.

Watch User Impersonation in Action!

Steps to Enable User Impersonation Permissions

You must be a Confluence admin to enable these permissions.

Click the Cog in the top right corner of Confluence
In the Settings panel on the left, find the Custom Jira Charts section, and click Custom Jira Charts - Settings
In the list of tabs under Custom Jira Charts - Settings, click User Impersonation
Click the Permission - User Impersonation section to expand it (number 1 in the image above). In this section, you are choosing users who can select their own Jira account as the one to impersonate permissions when viewing Jira data on Custom Jira Charts on Confluence
1. In the User Name search box, type in and select each user on an individual basis. Click Add to lock in each user
2. In the Group Name search box, type in and select Jira groups of users. Click Add to lock in each group

Users granted this permission can select ANY CONFLUENCE USER to impersonate when viewing Jira data on Custom Jira Charts.

This is a very powerful permission - for example:

Tom is an external contractor
Tom is granted the permission Impersonate Other Users for Custom Jira Charts
Tom creates a Custom Jira Chart on a Confluence page and impersonates Becky who is an administrator
The chart Tom creates shows the number of issues in the project “Top Secret” that only Becky should be able to see

This is a type of privilege escalation so you should be extremely careful when deciding who is given this permission.

Follow steps 1-3 above
Click the Permission - Impersonate Other User section to expand it (number 2 in the image above)
1. In the User Name search box, type in and select each user on an individual basis. Click Add to lock in each user
2. In the Group Name search box, type in and select Jira groups of users. Click Add to lock in each group

With the Custom Charts or Issue List macro in Edit mode, click the User Impersonation icon on the right side (number 1 in the screenshot above)
Click the USER IMPERSONATION radio button
In the IMPERSONATION USER search box, type in the name of the Jira user who’s permissions should be used when loading charts

With the Custom Charts or Issue List macro in Edit mode, click the Display options tab on the right side
Scroll to the bottom of the section until you see User Impersonation
Adjust your options if preferred:
1. Show impersonation user under chart: if toggled off (grey), the chart will load without the User Impersonation details displayed (image below has the option toggled on)
2. Allow click-through (requires Jira access): if toggled off (grey), chart viewers will not be able to click on the issue data and see it’s details in Jira (image below has the option toggled off)