# 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="/files/4HVyx9ajBBnxufGxYt0A" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://boxlang.ortusbooks.com/readme/release-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
