TestRail 10.4.1.1004 Server

Default release track date: 1-Jun-2026

We’re excited to announce the release of TestRail 10.4.1, bringing one of our most requested usability updates, and a significant investment in platform quality.

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');

  ⚙️  API Improvements

The latest TestRail API enhancements are designed to make integrations and automation workflows more efficient, with improved filtering capabilities that help reduce unnecessary data handling and simplify automation at scale.

Less API overhead, faster automation

• Dynamic filtering support for test runs through the API for more targeted data retrieval
• Reference filtering support for get_runs and get_plans
• case_id now returned in get_results_for_runresponses for easier result mapping
• A new edit_result/{result_id} endpoint that lets teams update existing results with support for partial updates, custom fields, and step results

These improvements help teams retrieve exactly the data they need with fewer API calls, less custom logic, and smoother automation workflows at scale.    

Better parity between UI and API

This release continues closing gaps between UI and API workflows with improvements such as:

• Support for updating existing test results via API
• Improved handling of update_run_in_plan_entry requests
• API formatting and consistency fixes

This helps teams automate workflows more reliably and reduce discrepancies between manual and automated operations.

Cleaner execution history and data consistency

Additional API and formatting improvements help preserve submitted data more accurately and improve execution history consistency across workflows.

🧩 Quality Improvements

TestRail 10.4 also includes a significant round of quality improvements focused on stability, reporting accuracy, performance, and Jira integration reliability.

These updates improve consistency across core workflows and reduce operational friction for both manual and automated testing teams.

📣 Custom Fields - Important Update

To help maintain platform performance and stability at scale, TestRail now enforces a limit of 150 custom fields per instance. If this limit is reached, administrators will need to remove an existing custom field before creating a new one.

Existing custom fields are not affected.

💻 TestRail CLI 1.14.2

The latest version of the TestRail CLI is now available with new capabilities. You can now:

• Upload results for the new AI Test Case Template, including multi-dimensional quality ratings (requires TestRail 10.3.0 or higher)
• Combine step-level execution tracking with AI evaluation quality ratings for more advanced AI testing workflows
• Apply global quality ratings to all test results using --result-fields
• Automatically detect and create AI Test Case Template test cases when using auto-creation mode (-y)
• Use custom case result statuses in Robot Framework and JUnit reports

🐞 Fixes and Improvements (23)

• TR-9065: API-submitted test results formatting improved
• TR-9276: Replaced attachments now display correctly
• TR-14188: Added case_id to get_results_for_run API response
• TR-14485: Resolved 403 errors for Project API endpoints
• TR-14959: Fixed the get_label API response to match the documented format.  
• TR-14986: Fixed issue preventing new user creation
• TR-16135: Added support for updating existing test results via API
• TR-16153: Added support for dynamic filters via API
• TR-16686: Fixed Jira hover and push issue errors
• TR-16916: Fixed attachment deletion for project_id 0
• TR-16988: Reference field updates now persist correctly in test plans
• TR-17088: Fixed API errors when fetching test cases
• TR-17297: Fixed filtering issues when creating sub-sections and test cases
• TR-18804: Improved dynamic filtering behavior with custom case fields
• TR-19150: Fixed PDF report download issues
• TR-19304: Added reference filtering support to get_runs  and get_plans APIs
• TR-19442: Audit log now captures user creation and update events
• TR-19455: Resolved duplicate test results returned by get_tests  API
• TR-19470: Improved performance when adding or editing test cases
• TR-19609: Corrected mismatched counts in Coverage for References reports
• TR-19628: Restored missing permissions section for SuperUser role
• TR-19728: Improved update_run_in_plan_entry  behavior consistency

📌 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.