1. Prerequisite

To connect Zoho QEngine to Jira, you need a Jira account and an API token generated from your Atlassian account.

Create a Jira account: A Jira account with access to an Atlassian site. If you haven't created a Jira workspace, navigate to Jira to create one.

Generate API token : Generate an API token from your Atlassian account. For steps to generate or retrieve your API token, refer to Atlassian's help guide.

2. Steps to configure integration with Jira

Note: Only super admin can configure the integration.

1. Navigate to the Setup page by clicking the {} icon in the top-right corner of the Home page.
   
   
   
   
2. Click Connect on the Jira card inside the Integrations tab. The Connect to Jira panel opens.
   
   
   
   
3. Provide the following details in the Connect to Jira panel and click Next.
   
   
   
   
   1. Enter your Atlassian site URL (for example, https://{sitename}.atlassian.net).
   2. Provide the email address of your Jira account.
   3. Provide your API token. Learn how to retrieve the API token from your Atlassian account

Note: You can't connect the same portal to more than one Jira or Zoho Sprints workspace at a time. If a connection already exists, you'll need to remove it before setting up a new one.

4. Select a Jira project and link it to a Zoho QEngine project.
   
   

5. Click Connect to complete the association.

This associates the first Jira project with your Zoho QEngine portal. To associate more projects later, see Associate projects with Jira

3. Managing Zoho QEngine and Jira projects association

You can perform the following actions once you've connected your Zoho QEngine portal with Jira.

1. Associate projects with Jira
2. Remove project association

Note: Super admin, admin, and manager can associate QEngine projects with Jira projects.

3.1 Associate projects with Jira

When you configure the integration, you link one QEngine project with a Jira project. To associate more projects with Jira, follow these steps:

Note:

1. Before associating, ensure you have a Jira account and a valid Jira API token ready. Learn more in Prerequisites
2. You can't associate the same QEngine project with more than one Jira or Zoho Sprints project at a time. If an association already exists, remove it before creating a new one.

1. Navigate to your project Settings > Integrations.
2. Click Associate in the Jira card.
   
   
   
   
3. Select the required project from the Jira Project drop-down and click Associate in the associate panel.

Note: If a project association appears inactive, the linked project in the connected Jira site has been archived. To re-enable the integration, activate the project in Jira.

Alternatively, you can associate projects from within the Setup inside the home page.

Note: Only super admins and admins can associate a project from the Setup page.

1. Click the {} icon in the top-right corner of the Home page to open Setup.
   
   
   
   
2. Click on the project count link on the Jira card in the Integrations tab. This opens the listing page that shows the existing associated projects, along with their status (Active, Inactive).
   
   
   
   
3. Click Associate Project to associate a new QEngine project with a Jira project.
   
   
   
   
4. Select the required QEngine and Jira project and click Associate.
   
   

3.2 Remove project association

To disconnect a Zoho QEngine project from a Jira project:

Note: Removing the association revokes your permissions to report bugs to the associated Jira project. The status of existing bugs will no longer be visible in Zoho QEngine but will remain accessible in Jira. Reconnecting the same Jira project later won't auto-sync previously reported bugs.

1. Navigate to your project Settings > Integrations.
   
   
   
   
2. Click the ellipsis icon of the required project association and click Remove.
   
   
   

Alternatively, you can remove the project association from the Setup page in Home.

Note: Only super admins and admins can remove a project association from the Setup page.

1. Click the {} icon in the top-right corner of the Home page to open Setup.
   
   
   
   
2. Click on the project count link from the Jira card in the Integrations tab. This opens the listing page that directs to the existing associated projects.
   
   
   
   
3. Hover over the required project association and click Remove.
   
   

4. Managing Jira integration

The Jira card enables you to view, edit, disconnect, disable, and enable the integration. Only super admin can perform these actions from the Jira card within Setup.

4.1 Edit integration

Edit your Jira integration if your Jira API token expires or becomes invalid. Reconnecting the integration requires a new token. Learn how to generate Jira API token

1. Click the {} icon in the top-right corner of the Home page to open Setup.
   
   
   
   
2. Click the ellipsis icon and select Edit from the Jira card to update your credentials.
   
   
   
   
3. Enter your updated email address and API token in the edit panel and click Update to save your changes.
   
   

4.2 Disconnect integration

You can disconnect the integration with Jira if you no longer want to stay connected to that Jira site.

Note: Disconnecting removes the portal's integration with Jira, so you'll no longer be able to report bugs to Jira from Zoho QEngine. Existing linked bugs won't be visible in QEngine but remain available in Jira. Reconnecting your Jira site later won't auto-sync older bugs.

1. Click the {} icon in the top-right corner of the Home page to open Setup.
   
   
   
   
2. Click the ellipsis icon and select Disconnect from the Jira card.
   
   
   

4.3 Disable and enable integration

You can temporarily disable the Jira integration without fully disconnecting it. This is useful when you want to pause bug reporting during a Jira maintenance window, or while reviewing your project setup, without losing your saved credentials and project associations.

1. Click the {} icon in the top-right corner of the Home page to open Setup.
   
   
   
   
2. Click the ellipsis icon and select Disable from the Jira card to pause the integration.
   
   

Once disabled, users cannot report a bug or associate a project. To resume the integration, click Enable on the Jira card.

5. Related links

1. Integrating Zoho QEngine with Jira
2. Report bugs in test cases from Zoho QEngine with Jira

6. What's next