NOTE: Currently this integration is for JIRA Cloud. For JIRA On-Prem users, we encourage the use of our Report a Bug feature instead.
FullStory's integration with JIRA makes it easy to create a new JIRA ticket when you notice a bug or issue in a customer's session in FullStory. We'll automatically send all the details we have about the customer's session (including a link to the playback and the customer's URL, IP address, UserAgent, and Viewport details), making it faster and easier to understand and reproduce the customer's experience and start solving the problem.
Setting up the Add-on
- Log in to the FullStory account for which you want to install JIRA.
- Log in to JIRA.
- Find the FullStory for JIRA add-on listing in the Atlassian Marketplace.
- Click Accept & install to add the FullStory for JIRA add-on to your JIRA instance.
- Once the add-on is installed, click Get Started to set up the configuration.
- Set the Project and Issue Type. When you share a FullStory note to JIRA it will be for the project and as the issue type you indicate here. (You can change these defaults later in FullStory settings). Then click Save Configuration. NOTE: If you're missing some Projects in the dropdown, scroll to the end of this article to see how to troubleshoot.
- Now that you've enabled and set up the add-on, when you make a note on a FullStory session, you'll see the option to share that note to JIRA.
- When you click SEND TO: JIRA, you'll see a new window where you can customize the content used to create the ticket. We'll automatically use your note text as the summary and we'll add all the session details to the description section of the ticket. You'll also need to set any required fields as you're creating the JIRA ticket.
- Click Send and the ticket will be created in JIRA. Look for the success notification in the bottom right hand corner.
- You can click on the note link in this pop-up notification to view the newly created ticket in JIRA. You can find this link again by clicking on the 'JIRA' link in your FullStory playback note again.
Updating your Default Settings
By default, all of your JIRA notes will be sent to the Project you indicate and be set as the Issue Type you indicate during setup. You can change the default settings any time you need from FullStory settings.
- Navigate to Settings > Integrations & API Keys
- Next to JIRA, click View.
- Use the pop-out menu to disable the integration or change the issue or project type.
- The project I want doesn't appear as an option when configuring the add-on (step 6 above)
Often, this is a permissions issue. The FullStory add-on must have "create issues" permissions on any project that you want to use. Typically, this permission is granted by default when you first install the add-on, but depending on your JIRA configuration this may not be the case. To view or edit project-level permissions, go to [cog in the upper right] → Projects tab → [click on a project] → Permissions and then scroll down to "create issues".