/ /

Setting up the JIRA App Tile

Updated 3 months ago

As part of Simpplr's app tiles feature, we offer several out-of-the-box app tiles your org can set up on home and site dashboards. The article linked below gives an overview of how app tiles work, permissions around setting them up, and various requirements. 

Setting Up Out-of-the-Box App Tiles on Dashboards

 

This article explains the JIRA tile.

JIRA tile

With the JIRA app tile, we can conveniently fetch assigned tickets directly from your JIRA instance specific to the logged-in intranet user. Clicking on any of these tickets will take the user directly to the ticket in JIRA.
JIRA App tiles.jpg

To add a tile:

  1. From the App tile option, choose JIRA.

  2. Within this modal, choose View assigned tickets from the Tile type dropdown and provide an appropriate tile title.

  3. Configure settings: Choose between different configurations from the settings section for different parameters as per the requirements and proceed with Add to home.
    JIRA App tiles 3.png

Depending on this configuration, users will be able to customize how they want their tickets to display, both by type and priority.
JIRA tile personalize.gif

Before setting up the JIRA integration, ensure you have the following:

  1. JIRA admin access: You must have admin access to the JIRA account from which you wish to fetch assigned tickets.

  2. JIRA username: Obtain the username associated with the JIRA account. You will need this when setting up the integration in Simpplr.

  3. JIRA token: Generate an API token from your JIRA account. This token will serve as the password for authentication purposes. To create a token, navigate to https://id.atlassian.com/manage-profile/security/api-tokens and choose to create a new token and provide an appropriate label for reference. You will need this when setting up the integration in Simpplr.

  4. JIRA URL: Determine the URL of your JIRA instance. You will need this when setting up the integration in Simpplr.

Note that in order for a successful connection, the user's accurate email address is required. Every user using the JIRA tile should have an email associated with their account in the Simpplr platform for it to function correctly.

Connection verification is also required. The verification of the connection setup at the app level happens only when a corresponding JIRA tile is rendered. If the connection is incorrectly set, then users will see a `Something went wrong` on the tile itself.
JIRA App tile error.png

Setting up your org's JIRA Integration

To integrate JIRA with the intranet:

  1. In Simpplr, as the App manager, navigate to the Manage > Application > Integrations > Support & Ticketing.

  2. Click the checkbox next to Atlassian JIRA.

  3. Provide the following details:

    • Username: Enter the JIRA username associated with the admin account

    • API Token: Input the API token generated from the JIRA account

    • JIRA URL: Specify the URL of your JIRA instance

  4. Click Save. Note that these details will not be verified right away to ensure they are correct or not.
    JIRA App tiles 2.png

JIRA JQL tile

In addition to displaying recent JIRA tickets, you can also showcase tickets using custom JQL queries with the JIRA tile. App and site managers can easily add the Display tickets using JQL tile to home or site dashboards, selecting it from a library of pre-built app tiles.
JIRA JQL app tiles.jpg

The JQL query input can be user-defined or site manager-defined. Once you select the option, input the JQL query into the blank field, then click Add to site dashboard.
app tiles =JIRA 3.jpg\

The end result based on the query will appear on the dashboard.
JIRA app tiles end result.jpg

View recently reported Jira tickets

This tile displays the most recent Jira tickets reported by the user. 

Displays:

  • Ticket ID

  • Summary

  • Status

  • Created date

  • (Placeholder for Screenshot)

Required Inputs:

  • Jira project name

  • User authentication

Prerequisites & Setup:

  • Users must authenticate using their Jira account.

  • OAuth Configuration – An OAuth app must be set up within Jira.

  • Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the JIRA app.

  • Configure OAuth details as needed, then enable the app.

Create a JIRA Service Desk ticket

This tile allows users to submit a new JIRA Service Desk support request directly from their dashboard. It displays:

  • Ticket creation form

  • Summary

  • Description

  • Priority selection

  • (Placeholder for Screenshot)

Required Inputs:

  • JIRA Service Desk project name

  • User authentication

Prerequisites & Setup:

  • Users must authenticate using their JIRA account.

  • OAuth Configuration – An OAuth app must be set up within JIRA.

  • Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the JIRA Service Desk app.

  • Configure OAuth details, enable the app, and access it under Add tile.

View your Jira Service Desk requests (no Jira license required)

You can now see your own open Jira Service Desk requests directly inside Simpplr using a dedicated App Tile, without needing:

  • A Jira license

  • To log in to Jira

  • Access to the Jira backend

The tile uses a shared Jira service account behind the scenes and automatically shows tickets that you have created in Jira Service Management (Service Desk).

What you’ll see

The “Display service desk requests” tile shows only your open Service Desk requests with:

  • Ticket ID

  • Summary

  • Status

  • Priority

By default:

  • Only requests you created are shown

  • Closed / Done tickets are excluded

  • Clicking a ticket opens it in the Jira Service Desk portal (the same place you normally track requests)

Who is this for?

This is designed for employees who:

  • Don’t have a Jira license

  • Don’t use the Jira backend

  • Only interact with Jira through the Service Desk portal

If that’s you, the tile gives you a simple way to track your requests directly from your Simpplr intranet.

How it works (in simple terms)

  • Simpplr uses a shared Jira service account to call Jira

  • When you open the tile, Simpplr sends your user identifier (such as your Jira account ID or mapped ID) in the background

  • Jira is queried “on your behalf” using that ID

  • The results are filtered so you only see your own open Service Desk requests

You don’t need to sign in to Jira or manage any connections yourself.

What admins can configure (for awareness)

Your Simpplr/Jira admin can configure the tile to:

  • Limit to Service Desk projects only (mandatory)

  • Optionally filter by:

    • Status

    • Priority

    • Ticket / Request type

The tile is configured with:

  • Tile name: Display service desk requests

  • Description: Use an app level connection to show users their reported service desk requests.

These filters help ensure employees only see relevant Service Desk tickets and are not confused by non–Service Desk Jira projects.

FAQs

Q: I don’t see any tickets in the tile. Why?
Possible reasons:

  • You haven’t created any Service Desk requests

  • All your past requests are already closed / Done

  • Your Simpplr user profile is not yet correctly mapped to your Jira identity

If you believe you should see tickets but don’t, contact your intranet or IT support team.

Q: Can I see other people’s tickets?
No. The tile is intentionally designed to show only your own requests for privacy and clarity.

Q: Will this give me a Jira license?
No. The tile uses a shared Jira service account. You still don’t need or consume a Jira license to view your own Service Desk requests in Simpplr.

Was this article helpful?
Subscribe to receive updates on this article