# Release History

## Versioning Schema <a href="#versioning-schema" id="versioning-schema"></a>

BoxLang is maintained under the [Semantic Versioning](http://semver.org/) guidelines as much as possible. Releases will be numbered in the following format:

```
<major>.<minor>.<patch>
```

And constructed with the following guidelines:

* Breaking backward compatibility bumps the major (and resets the minor and patch)
* New additions without breaking backward compatibility bump the minor (and resets the patch)
* Bug fixes and misc changes bump the patch

## BoxLang Release & Support Lifecycle

Our release cadence follows a predictable yearly major-version schedule, with each release enjoying two years of Long-Term Support (LTS):

* **Active Support**: First 12 months after release – full feature updates, bug fixes & security patches.
* **LTS (Updates & Security)**: 2nd year – maintenance releases (minor improvements & security).
* **LTS (Security-Only)**: 3rd year – critical security fixes only, then archived.

This gives you a clear planning horizon and overlap between versions, so you can upgrade on your own schedule without ever being left unprotected.

### Support Lifecycle Chart

Here is our 5-year outlook.

<figure><img src="https://1598982152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ENvvb4b3Cmrr1qKj7y4%2Fuploads%2Fgit-blob-52a1bceac9b5c8fbf33cc8331d43d1905e95eeb4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="104.49920654296875" align="center">Version</th><th align="center">Active Support</th><th align="center">LTS (updates &#x26; security)</th><th align="center">LTS (security-only)</th></tr></thead><tbody><tr><td align="center"><strong>v1</strong></td><td align="center">2025 – 2026</td><td align="center">2026 – 2027</td><td align="center">2027 – 2028</td></tr><tr><td align="center"><strong>v2</strong></td><td align="center">2026 – 2027</td><td align="center">2027 – 2028</td><td align="center">2028 – 2029</td></tr><tr><td align="center"><strong>v3</strong></td><td align="center">2027 – 2028</td><td align="center">2028 – 2029</td><td align="center">2029 – 2030</td></tr><tr><td align="center"><strong>v4</strong></td><td align="center">2028 – 2029</td><td align="center">2029 – 2030</td><td align="center">2030 – 2031</td></tr><tr><td align="center"><strong>v5</strong></td><td align="center">2029 – 2030</td><td align="center">2030 – 2031</td><td align="center">2031 – 2032</td></tr></tbody></table>

* After the “security-only” phase, the version is **archived**: no further updates, but archives remain available for reference.
* Overlaps ensure there’s always at least one actively maintained release.
* All dates refer to calendar years; exact dates will align with our annual major-version launch each Q1.
