# Pin the tag version

Load one fixed release of the Screeb tag in your mobile app instead of the latest one, when your organization requires an auditable payload.

The SDK renders surveys and messages with the Screeb tag, which it loads in its latest release each time your app starts. You get fixes, new question types and new features without shipping a new build. If your organization requires a fixed, auditable third-party payload, you can pin one release of the tag instead.

> [!CAUTION]
> **Pinning freezes every update**
> A pinned version receives no update until you change the value and ship a new build: no bug fixes, crash and privacy fixes included, no security patches, no new features and no compatibility updates for new OS versions, devices or WebView releases. Surveys designed later may not render, or not show at all, if the pinned tag predates a feature they use. Only pin if a policy requires it, and review the version regularly.

## Pin a version

Add the `ScreebTagVersion` key to your app's `Info.plist`:

```xml
<key>ScreebTagVersion</key>
<string>0.43.0</string>
```

The value is an exact version, `MAJOR.MINOR.PATCH` (a leading `v` is accepted). Ranges, `latest` and partial versions such as `0.43` are not supported.

To go back to automatic updates, remove the setting and ship a new build.

## Check the pinned build

The version is not checked against the published releases. A version that does not exist (a typo, or a version never released) makes the tag fail to load: Screeb then stops working entirely in your app, with no survey, no message, no session replay and no error shown to your users. There is no fallback to the latest version, by design.

Before you release a pinned build:

1. Install it with the version set.
2. Open the app and display a survey.
3. Check that everything you expect renders.

## Choose a version

The published versions and what each one contains are listed in the [tag changelog](https://developers.screeb.app/sdk-js/changelog). Pick a version that already has every feature the surveys you plan to run use, and check the changelog again when you design a survey with a newer capability or when a fix you need ships.
