Prerequisites:

1. An Atlassian account with access to the target Jira dashboard.
2. Email and password login available for that account.
3. 2‑Factor Authentication (2FA) enabled on the account, with the 2FA secret key available.
4. The full dashboard URL you plan to display.

Info: See our guide: How to Set Up 2FA and Get a Secret Key.

This integration requires a direct Atlassian account login with an email and password. Federated login methods, such as signing in with a Google, Microsoft, or Apple account, are not compatible with this setup. Please ensure you use an account with basic authentication credentials.

Best Practice
For enhanced security and easier management, create a dedicated service account in Jira with read-only permissions for the dashboard you want to display. Use this account's credentials for Pickcel.

Step-by-Step Configuration:

1. Create the Dashboard App in Pickcel:

1. Log in to the Pickcel Console and navigate to Apps. Search for the Dashboard app and click on it. Then, click Create App.
   
   
   
2. Give a name to the app instance based on the dashboard you are configuring (e.g., "Project Tracker Jira Dashboard").
   
   
3. Now, select Jira from the dropdown menu. The fields required for configuring your Jira Dashboard will open on the right-hand side.
   
   
   
   

2. Fill in the Fields for Jira Dashboard Configuration:

This section requires precise information to generate a correct and secure Auth Token.

1. Atlassian Login URL: Log out of Jira (if you are already logged in on your browser). Go to the Atlassian login page. Copy the entire URL from your browser's address bar and paste it here.
   
   
   
   
   
2. Atlassian Email ID: Enter the email address that you use for logging in to your Atlassian Account.
   
   
3. Atlassian Password: Enter the password for that account.
   
   
4. Auth Secret Key: Enter the 2FA Secret Key you saved when setting up 2FA for the Atlassian account.
   
   
5. Dashboard URL: Log back into Jira and navigate to the exact dashboard you want to display. Copy the entire URL from the address bar and paste it here.
   
   
   

Click Generate Auth Token. The token will be generated and automatically pasted into the Auth Token field on the left, as shown below.

Enter Screen Selection Code (Optional): If you want to display only a specific portion of the dashboard, use the Pickcel Dashboard Screen Mapper Extension. Select the area you want to display, and upon confirming the selection, the code will be copied to your clipboard. Paste this code into the Screen Selection Code field.

Check this guide for more info: How to Use the Dashboard Screen Mapper Chrome Extension?

3. Set Refresh Interval and Session Expiry:

1. Refresh Interval: This setting defines how often the dashboard screenshot is updated. An interval of 30 minutes is a good starting point for most Jira boards. This means the signage screen will display a fresh view of your dashboard every 30 minutes.
   
   
2. Session Expiry: This forces a fresh login to prevent session timeouts from the service provider. A value of 5-8 hours is recommended.
   
   
   

4. Enable Scroll Option for the Dashboard :

1. Enable Auto Scroll: This lets you set a scroll duration in seconds. For example, if you set it to 20 seconds, the entire dashboard will scroll from top to bottom over 20 seconds.
   
2. Enable Auto Scroll Height (Optional): This lets you set a scroll height in pixels. The screen will scroll down by the defined pixel height .
   
   
   

5. Create and Publish:

1. Once you are done with the configuration, click Create App. This successfully creates the app instance, which will be available to view in the Media section.
   
   
   
2. To preview the dashboard, go to Media, find the app instance by the name you created (e.g., "Project Tracker Jira Dashboard"), and click on its thumbnail (magnifier icon). This will display a preview. If you are content with the result, assign it to your digital signage screens.
   
   
   Here's the preview: 
   
   

1. The output is visible as a preview in the media section as shown above. It may take some time for the dashboard screenshot to load- depending on the dashboard app that is configured.
   
2. If the password or any other credentials are incorrect, the process will stall on the login screen, displaying the login screen instead of the dashboard. 

What's Next?
Your Jira Dashboard App is now ready. For further reading:

To create a multi-zone layout: Learn about Compositions.

To send it to your screens: Learn how to Publish or Schedule Content.