TestRail 9.3.1.1020 Docker Image

Default release track date: 10-Jul-2025

We’re excited to announce the release of TestRail 9.3.1, featuring major updates to Jira integrationa powerful new labeling system for Tests and Test Casesenhanced reporting performance, and several user-requested improvements designed to boost productivity for your QA teams.

Follow the Docker installation instructions here: TestRail 9.3.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:

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

 

Breaking change on the get_suites endpoint - it's been updated to support pagination. Updated get_suites documentation here.

Jira - Free logo icons Enhanced Jira Integration with OAuth 2.0

Our built-in Jira integration for Defects and References now supports secure authentication via OAuth for both Jira Cloud and Jira Data Center. This simplifies the integration setup and enhances security by moving away from API keys.

  • Jira OAuth integration provides a more user-friendly setup and stronger data security.
  • The previous integration for Jira Server will remain available (since Jira Server does not support OAuth 2.0).
Easily configure Jira OAuth integration in TestRail 9.3.0
Easily configure Jira OAuth integration in TestRail 9.3.0

 

Important: All existing Jira integrations will be cleared as part of this update. Customers will need to re-configure their Instance, Project, and User-level integrations after upgrading to 9.3.0.

🏷️ New Labeling for Tests and Test Cases

Labeling replaces the need for custom multi-select fields and gives teams a more flexible, scalable way to categorize their Tests and Test Cases. With this feature, you can:

  • Create and manage labels for both test cases and individual tests (within runs/plans).
  • Filter, sort, and classify your work by labels - ideal for organizing by priorities, risk, product areas, or components.
  • Assign labels at the test level, so the same test case can have different labels in different test runs or plans.
  • Admins and Project-Level Admins now have access to a Label Management tab in each project’s Admin page for easy label control.

Test and Test Case Labels

Admin > Projects > Label Management

📊 Report Performance and Scalability

With this release, we’ve significantly improved the performance and scalability of report generation in TestRail:

  • Reports now generate faster, even for larger projects with extensive data.
  • This helps you get the information you need more quickly, especially valuable for managers and teams running regular, large-scale reporting.

✨ Additional Improvements

  • Increased Character Limit for Reference and Defect Fields
    • Reference and defect fields now support up to 2,000 characters.
  • Start and End Date for Runs and Plans
    • Set and view start/end dates for Test Runs and Test Plans for better schedule management.
  • Expand/Collapse for Sections
    • New controls let you expand or collapse sections in your test case and section navigation for easier management of large suites.
  • Shortlinks for URL Fields
    • All URL fields now display as shortlinks, making long links easier to read and open.

🐞 Fixes and Improvements (25)

  • TR-14992: Localization - Pagination not working on Runs in French, Spanish and German
  • TR-14952: Case Improvements - API - Start date and End date are not set if user creates plan entry/run in plan entry via API
  • TR-14951: Case Improvements - API - "error": "Undefined property: stdClass::$run_start_on" error is shown if user tries to update plan entry with or without start_on/due_on parameters
  • TR-14684: Reports - The query processor ran out of internal resources and could not produce a query plan. error appears when generating Workload Summary
  • TR-14980: Case Improvements - API - If "labels" parameter in add_case contains integer which does not coincide with any label, new label with this integer(number) as a title is created
  • TR-14957: "Pending Save" with empty instance and user is shown on user-level configuration if another config was interrupted before - visual only
  • TR-14954: When creating user integration for project integration - "Pending Save" is shown for both project integration and instance integration (visual only)
  • TR-14940: Case Improvements - Labels - API - Labels are not updated properly if decreased from 10 labels
  • TR-14938: Case Improvements - Labels - API - Response to get-cases request where label_id parameter has multiple values contains duplicates for cases
  • TR-14912: Case improvements - Labels - wrong test cases matched shown in filter
  • TR-14896: Test Case - Reference field - Work count vanishes if you change template
  • TR-14851: Labels: When typing new label name into input field some typed characters are skipped (depends on the typing speed)
  • TR-14794: Case Improvements - Labels Management tab - Behavior is not consistent with other project tabs
  • TR-14786: Case Improvements - Test Run - Test Labels information not updated in Test Run list once label is added in Fast Track
  • TR-14674: Case improvements - Labels - Wrong number on bulk delete labels
  • TR-14670: Case improvements - Labels - Cases are copied or moved to other sections without labels
  • TR-14619: Test Cases / Test Runs&Results- Issues with URL field character limit
  • TR-14301: Test Runs&Results - Test Run Starts On shows end date for a configuration under a test plan (clarification needed)
  • TR-14300: Test Runs&Results - Plan entry (test run inside a test plan) has no dates on its card even if the dates were indicated (clarification needed)
  • TR-14292: Reports - Share Report - UI - recipient-emails textarea layout does not fit into the pop-up
  • TR-14253: Test Cases - Comments - New comments are only shown after page reload on Status and Assign to modals
  • TR-14043: Integration - A message that some projects override the global integration is misleading
  • TR-13946: Integration - Jira DC - Configuring Jira integration with bad credentials doesn't show the right message
  • TR-14848: 9.3 - Localization changes for the UI
  • TR-13586: When a user types of Japanese text in a text field and presses the "Enter" key to confirm the characters, a line break is unexpectedly inserted, and the cursor moves to the beginning of the next line.

Get access to TestRail 9.3.1.1020

TestRail version 9.3.1.1020 has been released for general availability to users on the Early Access release track. Get access to the features/fixes introduced in TestRail 9.3 now by completing your request to change release tracks here.

Was this article helpful?
0 out of 0 found this helpful