Default release track date: 26-Dec-2025
We’re excited to announce the release of TestRail 9.8.1, introducing one of the most requested usability upgrades - the Rich Text Editor. This release brings a faster, cleaner, and more intuitive text editing experience across the platform, while maintaining full markdown compatibility.
On top of the above, this release also improves platform stability and performance across core workflows, especially in report generation, chart visualization, and Jira integration, helping teams work with greater confidence and less friction in their daily workflows.
If you’ve experienced failed reports, missing charts, or problems pasting Jira issues into defect fields, this update should bring immediate and noticeable improvements.
Follow the Docker installation instructions here: TestRail 9.8.1 on Docker
Please note that our recommended upgrade path is via TestRail 8.0.4. 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 9.8.1
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');
📝 Rich Text Editing
Modern, Intuitive, and Backward Compatible
TestRail 9.8 introduces a modern Rich Text Editor across all major text fields. The new editor replaces markdown-only formatting with a professional WYSIWYG (What You See Is What You Get) experience, making test authoring more efficient and visually consistent.
- Enhanced text authoring: bold, italic, underline, colors, lists, links, tables, and more, all accessible from an intuitive toolbar.
- Rich media support: insert images and attachments directly into text fields with drag-and-drop capability.
- Streamlined experience: clean design, instant formatting preview, and contextual quick-insert options for faster editing.
- Markdown compatibility preserved and upgraded: all existing test cases using markdown remain fully supported and upgraded to the new formatting.
- Consistency across TestRail: available by default in key fields such as test cases, steps, expected results, and descriptions.
This enhancement delivers faster test case creation, improved readability, and a more professional documentation experience for QA teams of any size.
🔗 Integration Cards Updates
We’ve added new cards under Administration > Integration > Integrations page, for quicker access to documentation and setup instructions.
These include:
💻 TestRail CLI 1.12.5
The latest version of the TestRail CLI is now available with new capabilities:
- You can now use the new --parallel-pagination option when importing large test result files for improved performance and more reliable error handling.
-
This release also includes the following fixes:
- The label add command now correctly adds labels to projects.
- Errors from failed attachment uploads (e.g., due to large file size) are now properly shown in the standard output.
- Test cases are no longer deleted from existing test runs with configurations in test plans.
🐞 Fixes and Improvements (11)
- TR-11211: Fixed an issue where memory exhaustion caused crashes during certain operations.
- TR-12512: Fixed “Out of Memory” errors message issues.
- TR-12562: Resolved an issue where the "Report Details > Chart" section displayed "No data to display" incorrectly.
- TR-14897: Reports with multi-select custom fields failing to generate
- TR-15065: Addressed performance issues that caused some reports to take longer or fail to generate.
- TR-16114: Fixed missing bar charts in the Property Distribution and Workload Summary reports.
- TR-16200: Error when importing CSV files
- TR-16577: “Invalid filter definition” error when filtering tests by labels
- TR-16687: Defects & References field - Copy/ paste and Count functionalities not working as expected.
- TR-16785: Test steps being deleted after entering "Edit" mode
- TR-16822: Fixed a bug where pasted values in the Defects/References fields were not saved correctly in Jira-integrated instances.
📌 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.