Versioning & Support

This page covers the SDK's versioning scheme, the supported Android and toolchain versions, the deprecation policy, and how to reach Zeta support.

Semantic versioning

The SDK follows Semantic Versioning 2.0.0:

Major (X.y.z) — breaking changes to public API surface.
Minor (x.Y.z) — additive, non-breaking changes.
Patch (x.y.Z) — bug fixes that are backward-compatible.

Breaking changes are always documented in the Migration Guide. The full API-level record is in the Changelog.

Supported Android, Kotlin, and Gradle window

Tool	Minimum	Notes
Android API level (minSdk)	24 (Android 7.0)	Enforced in the SDK's `build.gradle.kts`.
Compile SDK (compileSdk)	34 (Android 14)	Your app's `compileSdk` must be 34 or higher.
Target SDK (targetSdk)	34+ recommended	Follow Google Play's target API level requirements. The SDK does not enforce a `targetSdk`, but targeting 34+ ensures compatibility with Android 14 behavior changes.
Kotlin	1.9+	The SDK is compiled with Kotlin 1.9.x.
Gradle	8.4+	Required for AGP 8.2+.
Android Gradle Plugin (AGP)	8.2+	Required for `compileSdk 34` and current Kotlin compatibility.

Release cadence and deprecation policy

Cadence: Minor and patch releases ship as features land and bugs are fixed. Major releases ship when there is a deliberate API break — they are not scheduled on a fixed calendar.
Deprecation: Public APIs marked @Deprecated continue to compile for at least one full major version after the deprecation warning appears. The replacement API is documented in the deprecation message and in the Migration Guide.

Support channels

Knowledge base — https://knowledgebase.zetaglobal.com
Account team — contact your Zeta account manager for SDK issues that require engineering triage.

Documentation versions

This page describes the current SDK version. If you are using an older SDK version, select the matching documentation version from the Version dropdown at the top of the page. Each documentation version is a snapshot of the docs as published at the time of that SDK release.

For the full list of documentation versions and the SDK versions they cover, see the documentation versions table.