Skip to main content
This guide details how to display a Jira dashboard on your digital signage screens using Pickcel. This is perfect for keeping your teams aligned on sprint progress, issue tracking, and project velocity.

​
Prerequisites

Before you begin, make sure you have:
  • An Atlassian account with access to the target Jira dashboard
  • Email and password login available for that account
  • 2‑Factor Authentication (2FA) enabled on the account, with the 2FA secret key available
  • The full dashboard URL you plan to display
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

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

Fill in the Fields for Jira Dashboard Configuration

This section requires precise information to generate a correct and secure Auth Token.
  • 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.
Atlassian Login URL Jira Configuration Fields
  • Atlassian Email ID: Enter the email address that you use for logging in to your Atlassian Account.
  • Atlassian Password: Enter the password for that account.
  • Auth Secret Key: Enter the 2FA Secret Key you saved when setting up 2FA for the Atlassian account.
  • 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.
Dashboard URL CopyJira Dashboard Fields
Click Generate Auth Token. The token will be generated and automatically pasted into the Auth Token field on the left.Generate Auth Token

​
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

  • 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.
  • Session Expiry: This forces a fresh login to prevent session timeouts from the service provider. A value of 5-8 hours is recommended.
Refresh Interval and Session Expiry Settings
4

Enable Scroll Option for the Dashboard

There are two ways to scroll through your entire dashboard:
  • 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.
  • Enable Auto Scroll Height (Optional): This lets you set a scroll height in pixels. The screen will scroll down by the defined pixel height.
Scroll Options
5

Create and Publish

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.Create App ButtonTo 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.Media Section Preview
Jira Dashboard Preview

Preview of the Jira Dashboard

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.
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: