> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrativebanking.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versioning policy

> How Narrative SDK versions are numbered and what compatibility you can expect.

# Versioning policy

Narrative SDK follows semantic versioning (`MAJOR.MINOR.PATCH`) for public releases.

## Current release line

* Active release line: `v1.5`
* Latest published version in this line: `v1.5.12`

## Compatibility commitments

* Releases at the patch position (for example, `1.5.1` to `1.5.12`) can include fixes, quality improvements, and new capabilities. They do not introduce breaking API contract changes.
* Minor releases (for example, `1.5.x` to `1.6.0`) can add capabilities while remaining backwards compatible.
* Major releases (for example, `1.x` to `2.0.0`) may include breaking changes.

## What is considered a breaking change

A change is treated as breaking if an existing integration must be updated to keep working, for example:

* removing or renaming public endpoints or fields
* changing request or response formats in an incompatible way
* changing authentication or authorisation requirements for existing endpoints

## Release notes commitment

Each published version includes release notes that summarise user-facing changes and any migration impact.

If a breaking change is introduced in a future major version, migration guidance is provided in the associated release notes.