# Card Reveal SDK Versions

Column's [card reveal SDKs](/card-issuing/card-reveal) for the web (`@column-na/card-reveal`) and React Native
(`@column-na/card-reveal-react-native`) release together at the same version and follow
[semantic versioning](https://semver.org). This page explains which versions Column supports, how you hear about
changes, and what happens when a version is no longer supported. See the
[changelog](/card-issuing/card-reveal-changelog) for what changed in each version.

## Support Policy

- **Column supports the latest two minor versions** of the SDKs, for example 0.12.x and 0.11.x. Older versions keep
  working until Column raises the minimum version, with notice.
- **Security fixes may require upgrading within 30 days** of the release that fixes them. If an issue can't wait,
  Column can raise the minimum version sooner and will tell you at the same time.
- **Pin an exact version** (`npm install --save-exact`, or the hosted script with its `integrity` hash), and upgrade
  deliberately. Each hosted version is published once and never changes.

## How Column Tells You

Before raising the minimum version, Column emails your platform's technical contacts with the date, the version to
upgrade to, and what changed. Every release is listed in the [changelog](/card-issuing/card-reveal-changelog), with
breaking changes and required actions first.

## How the Minimum Version Is Enforced

Each reveal request tells Column which SDK and version made it. When a version is below Column's minimum, Column
refuses the reveal before using the reveal token:

- The SDK's `ready` rejects with a `CardRevealError` whose `code` is `reveal_failed`, `status` is `403`, and `apiCode`
  is `card_reveal_sdk_upgrade_required`.
- The reveal token isn't used up.
- Nothing is shown in the card's fields.

Handle `card_reveal_sdk_upgrade_required` like any failed reveal in your UI, and treat it as a signal to upgrade.

The current minimum is **0.7.0** for both SDKs: every reveal token is bound to a key from `prepareReveal()`, which
earlier versions don't have.