Skip to main content
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Jira Extension

What's on This Page:

Was this helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

About the Jira Extension

Qualtrics allows you to create or update issues in Jira based on events that happen in Qualtrics. For example, whenever a customer submits a negative product rating to your feedback survey, you can create a Jira issue based on it.

Qtip: For information on working with Jira issues after they’re created or updated, see Atlassian’s documentation.
Qtip: If you have questions about retrieving the IDs listed on this page (or have questions about other Jira-specific fields and functionalities), please visit the Atlassian community.

Connecting Jira Credentials to Qualtrics

Qtip: These steps can only be completed by a Brand Administrator.

Before you let users on the brand use the Jira task, you can specify a Jira account that can be used brand-wide. Go to the Extensions tab of the Admin page, and select Jira to get started.

the jira extension in the extension tab in admin

Once credentials are added here, anyone in the brand who has access to the Jira Task can use these credentials to create or update issues in that Jira account.

If you do not add brand-wide credentials, users creating Jira tasks will still have the opportunity to add their own Jira account, which will only be available to them.

Setting up a Jira Task

  1. Navigate to the Workflows tab of a survey or the global Workflows page.
    choosing create a new workflow and then event based
  2. Click Create a workflow.
  3. Choose whether you want your workflow to be Scheduled or Event-based. See Scheduled Workflows vs. Event-based Workflows for more information about each option.
  4. Set up the event for your workflow (if event-based) or determine the schedule (if scheduled).
    choosing the survey event, adding conditions, and choosing the task
  5. Click the plus sign ( ) and then Conditions to add conditions to your workflow. Conditions determine under what circumstances the workflow runs. See Creating Conditions for more information.
  6. Click the plus sign ( ) and then Task.
  7. Select Jira.
    selecting the jira task
  8. Determine whether you want to Update Issue or Create Issue.
    choosing the type of jira task
  9. Click Next.
  10. Select the account you’d like to connect to.
    selecting a jira account or adding a new one
  11. Click Add user account in the upper-right if you have a Jira account you’d like to link that isn’t on the list. Note that any accounts you add here will be only be accessible to you; in contrast, apps added by brand admins to the Extensions page can be used by the whole brand.
    Qtip: You can edit your connected account’s name by clicking the pencil icon in the account selection window. To disconnect your account, click the trash can icon. Be careful when deleting accounts, as any plugins using this account will no longer work.the pencil and trash can icons for editing or removing an account
  12. Click Next.
  13. Select the instance you’d like to create an issue on.
    completing the jira task setup
  14. Select the Jira project you’d like to create an issue for.
  15. Select the type of issue you’d like to create.
    Qtip: See Atlassian’s documentation on Issue types for more information. The list of available issues varies by your instance and project.
  16. If you are updating an issue rather than creating a new one, you will need to provide the issue’s key. An example of an issue key is XM-2565.
    Qtip: If the issue key is being saved in the response as survey data, you can also use Piped Text ( {a} ) to retrieve the key.
  17. Map your fields and values. See Mapping Issue Fields and Values for more information.
  18. When finished, click Save.

Mapping Issue Fields and Values

Qtip: If you would like more information about fields in Jira, please visit this Jira support page.

the map fields at the bottom of the jira task

Required fields are marked with a red asterisk ( * ). If you do not fill out a required field, you cannot create the Jira task.

  • Fields Required When Creating Issues: All issue types require a Summary, which is the name of the issue, or a brief title that explains what you will accomplish. Sub-Tasks also require you add a Parent. This is the issue ID (not issue key) of the task you want to add your sub-tasks to.
  • Fields Required When Updating Issues: You must add at least one field with a value of your choosing in order to be able to update an issue.

After the required fields are filled out, you can add any fields you want to the issue. Additional fields you can map vary by instance and project. Examples of common fields provided by Jira include:

  • Epic Link: The epic link you want to add to an issue.
  • Assignee: The Jira user you want to assign the issue to. You can search a user by their name and select them from the dropdown. Alternatively, you can paste in the user’s account ID (accountId), a 24-digit unique identifier.
  • Description: Write a general description of the issue, such as the work involved and the actions that will be taken to resolve it.
Qtip: Custom fields of any format (multi-answer, date picker, checkboxes, etc.) are compatible with this extension.

Adding Fields

mapping fields in the jira task

  1. Use the Piped Text button ( {a} ) to set the value of a field based on information collected in the survey.
    Qtip: If the workflow’s event is not based on survey responses, the Piped Text fields will be based on the source of your event, e.g., Ticket Data fields for ticket update events.
  2. To specify the value of more fields in the issue you are creating, click Add Field.
  3. To remove a field, click the minus sign ( ). You cannot remove default fields.

Click Save to finish setting up your Jira task.