Integrating VWO with Jira

About VWO-Jira Integration

Integrating VWO with Jira simplifies workflows by enabling the automatic creation of Jira tickets from VWO observations and hypotheses. This ensures your testing insights are instantly available in Jira for action. Thus, streamlining testing workflows and enhancing team collaboration.

Key Benefits

• Automated Issue Creation
  Eliminate the manual overhead and save time by automatically creating Jira tickets.
  
  
• Centralized Project Tracking
  Manage your VWO testing activities within your existing Jira workflows.
  
  
• Improved Team Collaboration
  Keep your team informed and aligned on testing progress and insights.

Using the VWO-Jira Integration

Prerequisites

To set up this integration, the user must have:

• Active VWO and Jira accounts
• Member access to create a Jira ticket from VWO. For more information, see Team-managed project roles in Jira.
• Owner and Admin level access in VWO. For more information, see Understanding VWO Account Heirarchy.

Enable and configure the VWO-Jira Integration

1. In VWO, navigate to the Integrations section.
2. Search for Jira.
3. Click Click to connect.
4. Click Enable Now. Once enabled, the screen within the VWO’s Jira Integration section looks like this:
   
   
   
5. On the Config tab, enter the following details:
   • Username (Jira email address)
   • Jira API Token
   • Your Jira Instance URL
6. Click Save.
   
   
   
7. In the Complete JIRA integration section, choose the feature for which you want to configure the integration.
   • Check the Enable for Observation box to enable Jira ticket creation for observations.
   • Check the Enable for Hypothesis box to enable the Jira ticket creation for hypotheses.
     
     For each feature, configure the following details:
     
     
   • Select the Jira project. The tickets will be created under this project.
   • Choose whether the Jira ticket must be created for all observations/hypotheses or only for selected ones.
     • Select Push all observations/Push all hypotheses to enable Jira ticket creation for all observations/hypotheses created in VWO. If this option is selected, a Jira ticket is created for each observation/hypothesis by default.
     • Select Let me choose to enable Jira ticket creation only for select observations or hypotheses. If this option is selected, the user can decide if they want a Jira ticket created for each observation or hypothesis individually.
8. Under Advance Settings, select the Default Ticket type for the Jira ticket that is created. Choose from Task, Bug, Story, or Epic.
   
   
   
9. Click Save.
10. [Optional] Once the configuration is saved, you can use the Create test ticket option to test it. This option is available only after you save the configuration. If the configuration is successful, clicking on Create test ticket creates a test Jira ticket under the configured Jira project.
    
    
    
    NOTE: Click Hide permanently to hide the Create test ticket option permanently. Once you hide this option, you won’t be able to create a test ticket from here again.

Create a Jira Ticket for an Observation through VWO

1. In VWO, navigate to Plan > Observations.
2. Click Create an Observation.
3. Enter the Description, Page URL, and Labels.
4. Check the Create as Jira ticket box.
   
   
   NOTE: While configuring the VWO-Jira integration, if the Push all observations option is selected, the Create as Jira ticket box is checked by default.
   
   
5. Click Create.

The observation is listed, showing it's connected to the Jira ticket.

Click Jira ticket to open the ticket in Jira. Alternatively, go to Jira and verify that a corresponding ticket is created in your project.

Create a Jira Ticket for a Hypothesis through VWO

1. In VWO, navigate to Plan > Hypotheses.
2. Click Create a Hypothesis.
3. Enter the required information, including the linked observation.
4. Check the Create as Jira ticket box.
   
   
   NOTE: While configuring the VWO-Jira integration, if the Push all hypotheses option is selected, the Create as Jira ticket box is checked by default.
5. Click Create.

The hypothesis is listed, showing it's connected to the Jira ticket.

Click View this in Jira to open the ticket in Jira. Alternatively, go to Jira and verify that a corresponding ticket is created in your project.

FAQs

Can I link existing VWO observations/hypotheses to Jira tickets?

Yes.

What happens if I delete an observation/hypothesis in VWO? Does the Jira ticket also get deleted?

No, the user must delete the ticket manually from the Jira project.

What permissions are required in Jira to create tickets via the VWO integration?

At least member-level permission is required.