---
title: "JMeter 5.3 Release Notes"
description: "Apache JMeter 5.3 release notes with 27 improvements and 19 bug fixes, plus upgrade notes from the official changelog."
url: https://docs.jmeter.ai/releases/5-3/
lastUpdated: 2026-10-01
source: docs.jmeter.ai
---

# JMeter 5.3 Release Notes

> **About these release notes**
> This page lists every documented change shipped in Apache JMeter 5.3, generated from the official changelog. For download and upgrade guidance, see [Download JMeter](/reference/download-jmeter/).

## Change summary

| Section | Changes |
| --- | --- |
| Incompatible changes | 2 |
| Improvements | 27 |
| Bug fixes | 19 |
| Non-functional changes | 34 |

## New and Noteworthy

### UX improvements

Added [Darklaf](https://github.com/weisJ/darklaf) look and feel that improves several components.

Tree indentation level is easier to follow:

![JMeter tree with Darklaf Darcula theme](/images/screenshots/changes/5.3/tree_theme_darcula.png)

*JMeter tree with Darklaf Darcula theme*

![JMeter tree with Darklaf IntelliJ theme](/images/screenshots/changes/5.3/tree_theme_intellij.png)

*JMeter tree with Darklaf IntelliJ theme*

New look and feel themes. Light: IntellJ, Solarized Light, HighContrast Light.
Dark: OneDark, Solarized Dark, HighContrast Dark.

When an element in tree is disabled, all its descendants are shown in gray.
For instance, `While Contoller` is disabled in the following tree, so its children
are gray. It is purely a UI change, and the behavior is not altered.

![While controller is disabled, so its children are gray](/images/screenshots/changes/5.3/disabled_subtree.png)

*While controller is disabled, so its children are gray*

Tree context menu is shown even in case the node selection is changed. Previously
the popup did disappear and it was required to select a node first and only then launch popup.

Look and feel can now be updated without a restart

Use `CTRL + ALT + wheel` for zooming
fonts. Previous shortcut was `CTRL + SHIFT + wheel`,
however, it conflicted with horizontal scrolling.

In-app zoom is more consistent (e.g. sometimes not all the labels or even panels were scaled).
For instance: log viewer, JSR223 code editor were not previously scaled with zoom-in/out feature

Tree context menu is shown for the full row, not for the label only

Undo and redo support for editable fields. Keystrokes are `CTRL + Z` /
`CTRL + SHIFT + Z`, or
`CMD + Z`/
`CMD + SHIFT + Z` depending on the operating system.
Undo is implemented on a field level basis (each fields has its own history), and the history is
invalidated when tree selection changes.

Mark the currently selected language in the options menu.

Mark the currently selected log level in the options menu.

Rework of many Test Element UI (JUnit Request, ForEach Controller, If Controller, Throughput Controller, WhileController,
Counter Config, XPath2 Extractor, Function Helper Dialog, Search popup, JMS Elements)

## Incompatible changes

- Default value of `httpclient4.time_to_live` has been modified from `2000` to `60000`,     this means HTTP connections will live longer than before. This     has impact on connection creation and SSL handshake, see [Bug 64289](https://bz.apache.org/bugzilla/show_bug.cgi?id=64289)
- The update to Groovy 3 ([PR#590](https://github.com/apache/jmeter/pull/590)) might break some old Groovy code of your tests. Have a look     at [the update notes for Groovy 3](https://groovy-lang.org/releasenotes/groovy-3.0.html)

## Improvements

#### HTTP Samplers and Test Script Recorder

- [Bug 64160](https://bz.apache.org/bugzilla/show_bug.cgi?id=64160)Test HTTP/S Test Script Recorder: Name transaction controller/ simple controller using prefix without “`-XXXX`” suffix
- [Bug 64289](https://bz.apache.org/bugzilla/show_bug.cgi?id=64289)Make `httpclient4.time_to_live` to `60000` to be closer to typical browser behavior

#### Other samplers

- [Bug 64288](https://bz.apache.org/bugzilla/show_bug.cgi?id=64288)JUnit Request: Improve UX
- [Bug 64407](https://bz.apache.org/bugzilla/show_bug.cgi?id=64407)Improve JMS Publisher UX. Contributed by Ubik Load Pack ([https://ubikloadpack.com](https://ubikloadpack.com))
- [Bug 64408](https://bz.apache.org/bugzilla/show_bug.cgi?id=64408)Improve JMS Subscriber UX. Contributed by Ubik Load Pack ([https://ubikloadpack.com](https://ubikloadpack.com))

#### Controllers

- [Bug 64277](https://bz.apache.org/bugzilla/show_bug.cgi?id=64277)ForEach Controller: Improve UX
- [Bug 64280](https://bz.apache.org/bugzilla/show_bug.cgi?id=64280)If Controller: Improve UX
- [Bug 64282](https://bz.apache.org/bugzilla/show_bug.cgi?id=64282)Throughput Controller: Improve UX
- [Bug 64287](https://bz.apache.org/bugzilla/show_bug.cgi?id=64287)WhileController: Improve UX

#### Listeners

- [Bug 64150](https://bz.apache.org/bugzilla/show_bug.cgi?id=64150)View Results Tree: Allow editing of response data in testers
- [Bug 63822](https://bz.apache.org/bugzilla/show_bug.cgi?id=63822)View Results Tree: Keep position of split pane while switching renderer mode

#### Timers, Assertions, Config, Pre- & Post-Processors

- [Bug 64091](https://bz.apache.org/bugzilla/show_bug.cgi?id=64091)Precise Throughput Timer schedule generation is improved significantly (e.g. 2 seconds for 10M samples)
- [Bug 64281](https://bz.apache.org/bugzilla/show_bug.cgi?id=64281)Counter Config: Improve UX
- [Bug 64283](https://bz.apache.org/bugzilla/show_bug.cgi?id=64283)XPath2 Extractor: Improve UX

#### Functions

- [Bug 64070](https://bz.apache.org/bugzilla/show_bug.cgi?id=64070)`_timeshift` function does not work with offset formatters
- [Bug 64275](https://bz.apache.org/bugzilla/show_bug.cgi?id=64275)Function Helper Dialog: Improve UX

#### I18N

- [Bug 64102](https://bz.apache.org/bugzilla/show_bug.cgi?id=64102)Add Chinese translation for Tools menu. Contributed by Liu XP (liu_xp2003 at sina.com)

#### Report / Dashboard

- [Bug 64380](https://bz.apache.org/bugzilla/show_bug.cgi?id=64380)Add a ‘`Median`’ field to the dashboard and make the response time percentile fields support floating-point numbers. Contributed by Keith Mo([https://github.com/keithmork](https://github.com/keithmork))
- [Bug 64378](https://bz.apache.org/bugzilla/show_bug.cgi?id=64378)HTML report generation should not fail if a plugin has registered a graph and is not more present in classpath, issue a warning instead

#### General

- [Bug 63458](https://bz.apache.org/bugzilla/show_bug.cgi?id=63458)[PR#551](https://github.com/apache/jmeter/pull/551)Add new template “Functional Testing Test Plan [01]”. Contributed by Sebastian Boga (sebastian.boga at endava.com)
- [Bug 64119](https://bz.apache.org/bugzilla/show_bug.cgi?id=64119)Use first renderer from `view.results.tree.renderers_order` property as default in View Results Tree
- [Bug 64148](https://bz.apache.org/bugzilla/show_bug.cgi?id=64148)Use gray icons for disabled elements in the tree, display subtree as gray
- [Bug 64198](https://bz.apache.org/bugzilla/show_bug.cgi?id=64198)Allow spaces in `\${...}` expressions around functions.
- [Bug 64276](https://bz.apache.org/bugzilla/show_bug.cgi?id=64276)Search popup: Improve UX
- [PR#573](https://github.com/apache/jmeter/pull/573)Improve the startup time: skip test plan UI initialization
- [PR#585](https://github.com/apache/jmeter/pull/585)Added JEXL3 as a syntax alias for JSyntaxTextArea. Contributed by drivera-armedia ([https://github.com/drivera-armedia](https://github.com/drivera-armedia))
- [PR#590](https://github.com/apache/jmeter/pull/590)Update Groovy to 3.0.3.

## Bug fixes

#### HTTP Samplers and Test Script Recorder

- [Bug 64400](https://bz.apache.org/bugzilla/show_bug.cgi?id=64400)Make sorting recorded samples into transaction controllers more predictable
- [Bug 64267](https://bz.apache.org/bugzilla/show_bug.cgi?id=64267)When preemptive auth is disabled HTTP Sampler does not automatically respond to Basic Auth challenge

#### Other Samplers

#### Controllers

#### Listeners

#### Timers, Assertions, Config, Pre- & Post-Processors

- [Bug 64091](https://bz.apache.org/bugzilla/show_bug.cgi?id=64091)Precise Throughput Timer might produce less samples when low test duration is used
- [Bug 64142](https://bz.apache.org/bugzilla/show_bug.cgi?id=64142)Presence of DebugPostProcessor in Test plan breaks ActiveThread Over time in report due to missing information
- [Bug 64196](https://bz.apache.org/bugzilla/show_bug.cgi?id=64196)Recurse into sub samplers more deeply when checking assertions
- [Bug 64196](https://bz.apache.org/bugzilla/show_bug.cgi?id=64196)Recurse into sampleResults for `AbstractScopedTestElement#getSampleList`
- [Bug 64381](https://bz.apache.org/bugzilla/show_bug.cgi?id=64381)PreciseThroughputTimer: On termination, log message contains negative value

#### Functions

#### I18N

#### Report / Dashboard

- [Bug 64059](https://bz.apache.org/bugzilla/show_bug.cgi?id=64059)Response Time Percentiles Over Time, unable to change the percentiles

#### Documentation

- [PR#547](https://github.com/apache/jmeter/pull/547)Correct Log level documentation. Contributed by jmetertea
- [PR#548](https://github.com/apache/jmeter/pull/548)Correct typos in documentation. Contributed by jmetertea
- [Bug 64022](https://bz.apache.org/bugzilla/show_bug.cgi?id=64022)Correct Chinese translation for “Ignore Sub-Controller blocks”. Provided by yangxiaofei77 (yangxiaofei77 at gmail.com)
- [PR#552](https://github.com/apache/jmeter/pull/552)Fix `client.rmi.localport` port allocation description. Contributed by anant-93
- [PR#543](https://github.com/apache/jmeter/pull/543)Clarify documentation of `__StringToFile` function regarding default value of `Append to file?` parameter. Contributed by Ori Marko
- [Bug 64302](https://bz.apache.org/bugzilla/show_bug.cgi?id=64302)Correct links to JMeter API in printable docs and BeanShell best practices and to JavaFX implementation website in all docs.      Reported by 2477441814 (2477441814 at qq.com)

#### General

- [Bug 63945](https://bz.apache.org/bugzilla/show_bug.cgi?id=63945)NPE when opening a file after file system change
- [Bug 64034](https://bz.apache.org/bugzilla/show_bug.cgi?id=64034)Shell scripts fail if space in `JAVA_HOME` path. Contributed by ray7219 (ray7219 at hotmail.com)
- [Bug 63856](https://bz.apache.org/bugzilla/show_bug.cgi?id=63856)Set `connectTime` on parent samples when using a transaction controller
- [Bug 64227](https://bz.apache.org/bugzilla/show_bug.cgi?id=64227)Error when loading Templates on Windows
- TestPlan UI: skip adding the entry to the classpath if the user clicks cancel

## Non-functional changes

- Build system upgraded from Gradle to 6.3 (from 6.1), Java 14 can be used now for the build
- [Bug 63963](https://bz.apache.org/bugzilla/show_bug.cgi?id=63963)[PR#546](https://github.com/apache/jmeter/pull/546)Updated jackson to 2.10.3 (from 2.9.10)
- [Bug 64120](https://bz.apache.org/bugzilla/show_bug.cgi?id=64120)Updated jsoup to 1.13.1 (from 1.12.1)
- [Bug 63809](https://bz.apache.org/bugzilla/show_bug.cgi?id=63809)Updated commons-dbcp2 to 2.7.0 (from 2.5.0)
- Updated Apache ActiveMQ to 5.15.11 (from 5.15.8)
- Updated bouncycastle to 1.64 (from 1.60)
- Updated asm to 7.3.1 (from 7.1)
- Updated Apache commons-codec to 1.14 (from 1.13)
- Updated Apache commons-pool to 2.8.0 (from 2.7.0)
- Updated equalsverifier to 3.1.9 (from 3.1.12)
- Updated Apache Groovy to 2.4.18 (from 2.4.16)
- Updated hsqldb to 2.5.0 (from 2.4.1)
- Updated hamcrest to 2.2 (from 2.1)
- Updated Apache httpclient and httpmime to 4.5.12 (from 4.5.10)
- Updated Apache httpcore and httpcore-nio to 4.4.13 (from 4.4.12)
- Updated Apache Tika to 1.24.1 (from 1.22)
- Updated jmespath to 0.5.0 (from 0.3.0)
- Updated Apache log4j to 2.13.1 (from 2.12.1)
- Updated junit4 to 4.13 (from 4.12)
- Updated junit5 to 5.6.0 (from 5.5.1)
- Updated slf4j to 1.7.30 (from 1.7.28)
- Updated ph-commons to 9.4.1 (from 9.3.7)
- Updated ph-css to 6.2.2 (from 6.2.0)
- Updated rsyntaxtextarea to 3.1.0 (from 3.0.4)
- Updated rhino to 1.7.12 (from 1.7.11)
- Updated SaxonHE to 9.9.1-7 (from 9.9.1-5)
- Updated cglib to 3.2.12 (from 3.2.9)
- Updated commons-lang3 to 3.10 (from 3.9)
- Updated freemarker to 2.3.30 (from 2.3.29)
- Updated hamcrest-date to 2.0.7 (from 2.0.4)
- Updated equalsverifier to 3.1.13 (from 3.1.12)
- Updated xstream to 1.4.11.1 (from 1.4.11)
- [PR#559](https://github.com/apache/jmeter/pull/559)Add a note to the source of TrustAllSSLSocketFactory, that it is not secure to trust everyone. Based on a PR from YYTVicky (yytvicky at github)
- [PR#588](https://github.com/apache/jmeter/pull/588)Add documentation on usage of InfluxDB v2 for real-time results. Based on PR from Jakub Bednář (jakub.bednar at gmail.com)

## Thanks

We thank all contributors mentioned in bug and improvement sections above:

- [Jannis Weis](https://github.com/weisJ/darklaf)
- Stefan Seide (stefan at trilobyte-se.de)
- jmetertea
- ray7219
- Sebastian Boga (sebastian.boga at endava.com)
- Liu XP (liu_xp2003 at sina.com)
- anant-93 ([https://github.com/anant-93](https://github.com/anant-93))
- Ori Marko (orimarko at gmail.com)
- Keith Mo([https://github.com/keithmork](https://github.com/keithmork))
- drivera-armedia ([https://github.com/drivera-armedia](https://github.com/drivera-armedia))
- [Ubik Load Pack](https://ubikloadpack.com)
- Jakub Bednář (jakub.bednar at gmail.com)

We also thank bug reporters who helped us improve JMeter.

- Michael McDermott (mcdermott.michaelj at gmail.com)
- yangxiaofei77 (yangxiaofei77 at gmail.com)
- Markus Wolf (wolfm at t-systems.com)
- Pierre Astruc (pierre.astruc at evertest.com)
- YYTVicky (yytvicky at github)
- 2477441814 at qq.com

Apologies if we have omitted anyone else.

## Useful links

- [Download JMeter](/reference/download-jmeter/)
- [Getting started guide](/getting-started/get-started/)
- [All release notes](/releases/)
- [Current changes page](/user-manual/changes/)
- [History of previous changes](/user-manual/changes-history/)
