Default release track date: 26-Mar-2026
We’re excited to announce the release of TestRail 10.2.0, introducing enhanced Jira coverage visibility, improved authentication support, and continued investments in modern testing workflows.
This release focuses on helping teams improve traceability and adopt more secure and flexible integrations.
Follow the Docker installation instructions here: TestRail 10.2.0 on Docker
Please note that our recommended upgrade path is via TestRail 9.4.1. If you’re still running TestRail 7.0 or below, you should follow the path below:
- upgrade to 7.5 first
- upgrade to 8.0.1
- upgrade to 8.0.4
- upgrade to 9.4.1
- and only then upgrade to 10.2.0
Once the upgrade is complete, you must open _config/config.php in your Docker files folder, and add new line with:
define('TR_CHROME_PATH', '/usr/bin/chrome-headless-shell-linux64/chrome-headless-shell');
Jira Coverage Check
TestRail now provides a new way to analyze test coverage across Jira entities, improving visibility into gaps between requirements and testing.
With Jira Coverage Check, you can:
- Evaluate coverage for Jira entities such as Sprints, Fix Versions, and Epics
- Run coverage checks across both the Test Cases Repository and Test Runs
- Identify uncovered items and navigate directly to Jira entities
- Export results via CSV for further analysis
🔐 Passwordless Login Support for Azure
TestRail now supports passwordless authentication for Azure SSO (SAML).
This update removes the previous restriction on authentication methods, allowing TestRail to accept users authenticated by Azure regardless of method (e.g., passwordless, MFA, certificate-based).
This ensures:
- Compatibility with modern Azure authentication methods
- Alignment with Azure as the identity provider
- A more secure and seamless login experience for users
🧪 BDD Syntax Support
BDD scenarios in TestRail now support proper Gherkin syntax rendering, making them easier to read and work with. Keywords such as Given, When, Then, And, and But are clearly formatted with syntax highlighting and structured layout, improving clarity for both manual and automated workflows. Combined with native Cucumber parser support in the TestRail CLI 1.13.3 teams can seamlessly run and report BDD automation end to end.
💻 TestRail CLI 1.13.4
The latest version of the TestRail CLI is now available with new capabilities. You can now:
- Extended glob support for robot parser for efficient multiple test result file processing
- Added
--run-assigned-to-idand--clear-run-assigned-to-idoptions to add_run command for clearing and setting test run assignees during run creation and updates - Receive version notifications and use a new
updatecommand to easily upgrade to the latest version (v1.13.3). - Handle multiple test result files with enhanced blob support, improving automation workflows (v1.13.3).
This release also includes the following improvements & fixes:
- Improved - Attachment handling and validation for custom fields
- Fixed - Cannot add empty runs via add_run command due to empty test case validation
API Update:
- update_run: included support for assignedto_id
🐞 Fixes and Improvements (15)
TR-10585: Test cases marked as deleted still visible after retention period
TR-12235: Resolved inconsistencies in case_assocs table
TR-12737: Variable values issues in pop-up
TR-16765: Added support for Azure passwordless login
TR-16842: Error when closing test plans resulting in internal server error
TR-17321: Pasted defect lists in Jira integration not saved correctly
TR-18487: Data loss when creating or updating test cases
TR-18623: Data Management export issue
TR-18640: Jira integration returning 401 error when editing issues
TR-18662: Column issues on property distribution report
TR-18671: Project-level permissions not applied correctly
TR-18785: Scheduled reports not being generated
TR-18833: Error when importing test cases due to missing estimate field
TR-19183: Error when opening tests within archived runs
TR-19290: DateTime error on Admin > Integration Page
📌 Cassandra Deprecation Enforcement
Starting with TestRail 9.5 Server, Cassandra is officially deprecated and enforcement is in place.:
- Admins must first run the Cassandra deprecation script in version 9.4.1 before upgrading to 9.5.
- If the script has not been executed, the upgrade to 9.5 will be blocked and a warning message will be displayed during the upgrade process.