diff --git a/_includes/docs/releases/release-policy.md b/_includes/docs/releases/release-policy.md
index 7934dcbde2..062127cad0 100644
--- a/_includes/docs/releases/release-policy.md
+++ b/_includes/docs/releases/release-policy.md
@@ -9,11 +9,11 @@ It’s written for platform administrators, SREs, DevOps engineers, and technica
## ThingsBoard versioning
ThingsBoard version numbers reflect the scope of changes introduced in each release. This follows semantic versioning principles, helping you gauge the potential impact of upgrading.
-ThingsBoard version numbers have four parts: MAJOR.MINOR.MAINTENANCE.PATCH. For example, version 4.2.1.0 indicates major version 4, minor version 2, maintenece 1 and patch level 0.
+ThingsBoard version numbers have four parts: MAJOR.MINOR.MAINTENANCE.PATCH. For example, version 4.2.1.0 indicates major version 4, minor version 2, maintenance 1 and patch level 0.
The version number is incremented based on the level of change included in the release.
-
+
| Level |
@@ -34,8 +34,8 @@ The version number is incremented based on the level of change included in the r
| MAINTENANCE |
- Bug fixes/security vulnerabilities/framework upgrades that may require upgrade scripts |
- Yes |
+ Bug fixes, security fixes, framework upgrades Note: Upgrade scripts are usually required, but not always (e.g. Angular 18→20) |
+ May be required |
| PATCH |
@@ -55,12 +55,13 @@ The version number is incremented based on the level of change included in the r
4.2.1.3 — Hotfixes on top of 4.2.1.0; zero‑downtime within 4.2.1.x
+4.2.2.0 — Maintenance release: includes Angular upgrade (18 → 20). No DB scripts required, but potential UI impact.
## Lifecycle & Support (How long versions are supported?)
ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users. Customers using LTS releases can be confident that their critical systems will be protected and operate reliably.
-
+
| Release Type |
@@ -95,10 +96,15 @@ ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users.
3. **Schedule maintenance windows** to adopt new **MAINTENANCE** releases when needed (e.g., 4.2.0.x → 4.2.1.0).
+4. **Framework upgrades in MAINTENANCE releases** (e.g., Angular 18 → 20):
+ * We provide **full backward compatibility for the core platform** and **do not require any upgrade scripts**.
+ * However, **custom UI code** (widgets or custom CSS) that depends on internal component structure or CSS variable names **may break**.
+ * This can affect **up to 1% of users** with heavy customizations.
+ * **Recommendation:** Always test custom UI in a staging environment before upgrading to such MAINTENANCE releases.
## Docker Hub Tagging Strategy
-
+
| Tag |
@@ -118,7 +124,7 @@ ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users.
M.m.P |
4.2.1-latest |
Automatic safe patches |
- Floating (within 4.2.1.x) |
+ Floating (within 4.2.1.x) |
| latest |