Skip to main content

Integrate Jira with Your Projects (Enterprise Only)

The Jira integration in A11yNow allows your team to seamlessly manage accessibility issues within Jira while maintaining synchronization with accessibility findings in A11yNow. By mapping projects, issue types, severities, statuses, and fields, you can streamline issue tracking, improve collaboration, and ensure accessibility defects are managed within your existing development workflow.

Pre-Requisites​

  • Before configuring a project-level integration, ensure that Jira has already been connected to A11yNow through the organization settings.

Connect Jira to a Project​

To connect GitHub on A11yInspect with your project:

  1. Sign in to BarrierBreak A11yNow.
  2. Select Projects module.
  3. Open the project you want to configure.
  4. Select the Integrations tab.
  5. Select Connect option under Jira. You will now redirect to configure the required integration settings.

Configure Jira Integration Setting​

After connecting the Jira, configure the required integration settings by proceeding with following steps:

Step 1: Select Project and Issue Type​

  1. Choose a Jira Project from the available list.
  2. Select the Issue Type that A11yNow should use when creating Jira issues.

Step 2: Configure Sync Options​

Choose any option to sync BarrierBreak A11yNow with GitHub. Refer the following table to understand the options:

  • Auto Sync: Automatically synchronizes updates between A11yNow and Jira.
  • Auto-Create Issues: Automatically creates Jira issues for new accessibility findings detected in A11yNow. If Auto-Create Issues is enabled, select which findings should generate Jira issues as All Issues, Fails, or Fails & Suggestions.

Step 3: Configure Parent Linking​

Choose any option to configure the parent linking as follows:

  • No Parent: The issues will be created in Jira without parent issues.
  • Choose During Sync: It will allow you to select the parent issue while manually syncing to Jira.
  • Default Parent: Select a parent issue from dropdown field. All the issues will sync under that selected parent issue.

Step 4: Map Severity Levels​

Configure following A11yNow severity levels correspond to Jira priorities as Highest, High, Medium, Low, Lowest.

  • Blocker nb
  • Critical
  • Major
  • Minor
  • Best Practice

Step 5: Configure Status Mapping​

Map A11yInspect issue status with the corresponding GitHub issue statuses as follows:

A11yNow Issue StatusJira Issue Status
To DoOpen
In ProgressOpen
DoneClose

Step 6: Field Mapping​

Map accessibility finding details to Jira issue fields to ensure all relevant information is synced correctly during issue creation. Field mappings can be customized based on your repository requirements. Refer to the table below to fields values (Summary, Description, Issue Color, Labels)

A11yNow FieldsJira Fields (Default)
IssueSummary
TypeLabels
SeverityLabels
Success CriteriaDescription
Conformance LevelDescription
ElementDescription
AttributeDescription
Actual ResultDescription
Expected ResultDescription
RecommendationDescription
Step To ValidateDescription
Existing CodeDescription

Step 7: Save the Configurations​

  1. Review all the configured settings
  2. Select Submit to save the configuration

All the configured integration details will be displayed on the project integration dashboard. You can edit configurations anytime.

Edit the Existing Jira Integration Settings​

Based on your requirements, you can edit existing configurations anytime.

To edit the integration settings:

  1. Sign in to BarrierBreak A11yNow.
  2. Go to Projects.
  3. Open the project you want to edit.
  4. Go to Integration tab.
  5. Select View Integration option under Jira.
  6. Select on Edit in the upper- right corner.
  7. Update the required configuration options.
  8. Select on Submit to save changes.

Disconnect GitHub Integrations​

To disconnect GitHub integration:

  1. Sign in to BarrierBreak A11yNow.
  2. Go to Projects module.
  3. Open the project you want to edit.
  4. Go to Integration tab.
  5. Select View Integration option under GitHub.
  6. Select Unlink Jira.

Now your Jira is unlinked with BarrierBreak A11yNow.

note

  • You must connect Jira in Settings before it can be linked to individual projects.