Overview of TestRail Integration Setup

Overview

The TestRail integration allows you to link your Nexus test cases to TestRail test cases and export test run results to TestRail. This creates a seamless connection between your automated testing in Nexus and your test management in TestRail.

What you can do:

• Connect Nexus to your TestRail instance
• Link TestRail cases to Nexus tests (at the test or step level)
• Export test results to TestRail with automatic status mapping
• Track sync status between Nexus and TestRail

Prerequisites

Before setting up the integration, ensure you have:

• A TestRail account with API access enabled
• A TestRail API key with the following permissions (inherits from your user):
  • Read access: get_projects, get_suites, get_cases, get_sections, get_statuses
  • Write access: add_run, add_plan, add_results_for_cases, close_run, close_plan
  • If you can do these actions via the TestRail web interface, your API key should have the necessary permissions.
• The project:edit-configs permission in Nexus (or project:admin / org:admin)

Connecting to TestRail

Selecting Project and Suites

After connecting successfully, configure which TestRail data to use:

Project Selection

Choose the TestRail project that corresponds to your Nexus project. You can only link cases from a single TestRail project per Nexus project.

Suite Selection

Select one or more test suites from your TestRail project:

• Search for suites by name using the search field
• Use Select All or Clear for bulk operations
• Only test cases from selected suites will be available for linking

Configuring Status Mapping

Status mapping determines how Nexus test results are reported to TestRail.

Understanding Nexus Results

When a test runs in Nexus, it produces:

• A run result: Success, Stopped, MaxSteps, or Error
• A bug label: NoBug, LikelyNoBug, Undecided, LikelyBug, or DefinitelyBug

Mapping Modes

Basic Mode

Basic mode (recommended for most users) maps each bug label to a TestRail status. The same mapping applies to all run results (Success, Stopped, MaxSteps).

Advanced Mode

Advanced mode lets you create different mappings for each run result type. This is useful if you need granular control over how different scenarios are reported.

Default Mapping

If you don’t configure custom mappings, Nexus uses these defaults:

You can reset to these defaults at any time by clicking Reset to Defaults.

Required Permissions

Next Steps

Once TestRail is configured, you can start linking test cases to your Nexus tests.