Updating the Rich Text Editor License Key (2026)

Starting with version 9.8.x TestRail uses a Rich Text Editor component which requires an annual license key update. If your instance has not been updated by end of June 2026, users will see a license warning message when opening a page that contains a rich text field (see below).

To update your license key, follow the steps according to your installation type.

Bare Metal (Linux)

1. Download the patch files - link.
2. Locate the folder in the patch archive that matches your TestRail version (e.g., froala-patches\testrail-10.3.1\).

3. Copy the patched JS files to your TestRail installation's js\bundle directory:

   cp froala-patches/testrail-<version>/testrail/js/bundle/application.search.js <TestRail installation path>/js/bundle/
   cp froala-patches/testrail-<version>/testrail/js/bundle/application-entrypoint.js <TestRail installation path>/js/bundle/

4. Set the correct file ownership:

   chown www-data:www-data <TestRail installation path>/js/bundle/application.search.js
   chown www-data:www-data <TestRail installation path>/js/bundle/application-entrypoint.js

Bare Metal (Windows)

1. Download the patch files - link.
2. Locate the folder in the patch archive that matches your TestRail version (e.g. froala-patches\testrail-10.3.1\).
3. Copy the patched JS files to your TestRail installation's js\bundle directory, replacing the existing files.

Docker

1. Download the patch files - link.

2. Identify your TestRail container name:

   docker ps

3. Copy the patched files into the container. Note: use . (dot) not * (asterisk) at the end of the source path:

   docker cp froala-patches/testrail-<version>/testrail/js/bundle/. <container-name>:/var/www/testrail/js/bundle

4. Set the correct file ownership:

   docker exec -it <container-name> chown www-data:www-data \
     /var/www/testrail/js/bundle/application.search.js \
     /var/www/testrail/js/bundle/application-entrypoint.js

Verify the patch

Log in to TestRail and open any page containing a rich text editor field. The license key warning should no longer be visible.