---
title: SDK version control overview
description: Didomi offers your organization flexible release management to control how updates are delivered to your environment(s). In this article, we will provided a brief overview of the different versioning
---

[Skip to content](https://support.didomi.io/sdk-version-control-overview#main-content)

English

Show submenu for translations

[Customer portal](https://support.didomi.io/tickets-view)

![Didomi SAS](https://support.didomi.io/hs-fs/hubfs/Didomi-tail-name.png?width=182&height=34&name=Didomi-tail-name.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Customer portal](https://support.didomi.io/tickets-view)
- Go to didomi.io

 Go to didomi.io

 Our documentation has moved to docs.didomi.io. Please update any bookmarks.

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.didomi.io/)
2. [SDK version control](https://support.didomi.io/sdk-version-control)

# SDK version control overview

Didomi offers your organization flexible release management to control how updates are delivered to your environment(s). In this article, we will provided a brief overview of the different versioning options and how the Didomi SDK version control feature applies per SDK type.

- [Versioning options](https://support.didomi.io/sdk-version-control-overview#versioning_options)
- [Versioning options per SDK type](https://support.didomi.io/sdk-version-control-overview#per_SDK)
- [Release notes and notifications](https://support.didomi.io/sdk-version-control-overview#release_notes)

**Note**: For all Didomi SDKs, we utilize semantic versioning to reflect the type of change between versions. The semantic versioning is a 3-component number format to indicate **Major.Minor.Patch**. In this schema, Didomi will update the major number for any breaking update, minor number for new features, and patch number for fixes.

---

### Versioning options

Didomi supports three different versioning options: continuous releases, latest official version, and pinned version. Regardless of which versioning option your organization selects, every release is tested and undergoes quality control before deployment to the Didomi production environment.  

- [Continuous releases](https://support.didomi.io/sdk-version-control-overview#continuous_releases)
- [Latest official version](https://support.didomi.io/sdk-version-control-overview#official_version)
- [Pinned version](https://support.didomi.io/sdk-version-control-overview#pinned_version)

![Screenshot 2025-10-15 at 12.46.16 PM](https://support.didomi.io/hs-fs/hubfs/Screenshot%202025-10-15%20at%2012.46.16%20PM.png?width=500&height=635&name=Screenshot%202025-10-15%20at%2012.46.16%20PM.png)

#### Continuous releases

When continuous releases is selected as the version control option for Didomi SDKs, every new update that Didomi deploys into production will be automatically applied to the consent notice.

This version control option enables your organization to receive the latest improvements and bug fixes with no additional effort or compromise on stability.

Didomi recommends the continuous releases version control option for organizations who want the fastest updates, first access to new frameworks and compliance support, and who do not need to validate changes in advance.

**Note**: For the Didomi [web SDK](https://support.didomi.io/web-sdk)and [web-based CTV SDK](https://support.didomi.io/web-based-ctv-sdk), continuous releases is the default version control option.

#### Latest official version

When latest official version is selected as the version control option for Didomi SDKs, Didomi will package all releases within a **2 week** time span into an official version that will then be automatically applied to your consent notice.

This version control option provides your organization with a measure of predictability with curated release notes detailing the updates grouped into the official version

Didomi recommends the latest official version control option for organizations who prefer more predictability and may require time to validate updates before they go live for consent notices.

**Hotfixes**

Didomi defines a hotfix as any urgent update required to address a security or compliance issue, or a critical bug affecting client revenue. If a critical bug is discovered (*e.g. preventing SDK initialization*), Didomi will deploy a hotfix immediately and force a **new** official version irrespective of the 3 week time span.

The new official version will include the hotfix and any updates that have been released since the last official version.

#### Pinned version

When pinned version is selected as the version control option for Didomi SDKs, your organization will select from the consent notice configuration flow which version of the SDK should be loaded (using Didomi's semantic versioning).

The version of the Didomi SDK is locked for the consent notice and will be used in the consent notice preview and where the consent notice is deployed on your websites/applications until your organization chooses to upgrade the SDK version.

**Note**: Didomi only allows your organization to utilize a pinned version of the SDK that is no older than 6 months. If your pinned version of the Didomi SDK exceeds 6 months, we will notify you within the Didomi console and via email, and automatically upgrade you to the latest SDK version if no action is taken. 

Didomi recommends the pinned version control option for organizations who require complete control over updates, need to manage freeze periods, or have involved QA processes.

When using pinned version as the version control option for the Didomi SDK, your organization will not benefit from any hotfixes that Didomi releases until the SDK version is upgraded. 

### Versioning options per SDK type

The availability for versioning options is dependent on both the type of SDK your organization is loading and, for some SDKs, your subscription tier. Please refer to the table for an overview of the available versioning options per SDK type:

| **SDK Type** | **Continuous releases** | **Latest Official Version** | **Pinned Version** |
| --- | --- | --- | --- |
| [Web SDK](https://support.didomi.io/web-sdk) | Default | Premium option | Premium option |
| [Web-based CTV SDK](https://support.didomi.io/web-based-ctv-sdk) | Default | Included | Included |
| Mobile SDKs (iOS/Android) | N/A | Included | N/A |
| Native CTV SDKs | N/A | Included | N/A |
| App v2 SDK | N/A | Included | N/A |

### Release notes and notifications

For every official version that Didomi releases, we will include a release note with the grouping of updates so that your organization can get an overview of the changes. These release notes can help inform your organization's QA process and, for organization's who utilize the pinned version control option, help inform decisions on upgrading to a particular SDK version. 

Release notes for Didomi SDKs can be found in our [developer portal](https://developers.didomi.io/). 

**Note**: There are no detailed release notes provided by Didomi for individual releases deployed through our continuous release process. These updates will be retroactively documented in the release note for the official version.

New features will be announced via the Didomi newsletter and social media channels.

- [Consent notice creation](https://support.didomi.io/consent-notice-creation#main-content)

    - [Basics](https://support.didomi.io/consent-notice-creation#basics)
    - [Consent notice per device](https://support.didomi.io/consent-notice-creation#consent-notice-per-device)
    - [Manage Vendors and Purposes](https://support.didomi.io/consent-notice-creation#manage-vendors-and-purposes)
    - [Customization](https://support.didomi.io/consent-notice-creation#customization)
    - [Multi-regulations](https://support.didomi.io/consent-notice-creation#multi-regulations)
    - [Frameworks](https://support.didomi.io/consent-notice-creation#frameworks)
    - [Integrations](https://support.didomi.io/consent-notice-creation#integrations)
    - [Console migration](https://support.didomi.io/consent-notice-creation#console-migration)
    - [IAB GPP Framework](https://support.didomi.io/consent-notice-creation#iab-gpp-framework)
    - [Accessibility](https://support.didomi.io/consent-notice-creation#accessibility)
- [Compliance report](https://support.didomi.io/compliance-report#main-content)

    - [CMP Vendor Sync](https://support.didomi.io/compliance-report#cmp-vendor-sync)
    - [Advanced Compliance Monitoring](https://support.didomi.io/compliance-report#advanced-compliance-monitoring)
- [Preference Management Platform](https://support.didomi.io/preference-management-platform#main-content)

    - [Configuration Tree](https://support.didomi.io/preference-management-platform#configuration-tree)
    - [Widget](https://support.didomi.io/preference-management-platform#widget)
    - [Deployment](https://support.didomi.io/preference-management-platform#deployment)
- [Google integrations](https://support.didomi.io/google-integrations)
- [Privacy Request](https://support.didomi.io/privacy-request#main-content)

    - [User Requests](https://support.didomi.io/privacy-request#user-requests)
    - [Widgets](https://support.didomi.io/privacy-request#widgets)
- [IAB TCF](https://support.didomi.io/iab-tcf#main-content)

    - [Google & TCF](https://support.didomi.io/iab-tcf#google-tcf)
    - [TCFv2 Presentation](https://support.didomi.io/iab-tcf#tcfv2-presentation)
    - [TCF v2.2](https://support.didomi.io/iab-tcf#tcf-v2-2)
- [Analytics](https://support.didomi.io/analytics#main-content)

    - [Consent Management Platform (CMP) Analytics](https://support.didomi.io/analytics#consent-management-platform-cmp-analytics)
    - [Preference Management Platform (PMP) Analytics](https://support.didomi.io/analytics#preference-management-platform-pmp-analytics)
    - [ACM (Advance Compliance Monitoring)](https://support.didomi.io/analytics#acm-advance-compliance-monitoring)
- [Integrations](https://support.didomi.io/integrations#main-content)

    - [AB testing](https://support.didomi.io/integrations#ab-testing)
    - [Paywalls](https://support.didomi.io/integrations#paywalls)
    - [CMS](https://support.didomi.io/integrations#cms)
    - [Generic integrations](https://support.didomi.io/integrations#generic-integrations)
    - [Marketing automation](https://support.didomi.io/integrations#marketing-automation)
    - [Customer Data Platform (CDP)](https://support.didomi.io/integrations#customer-data-platform-cdp)
    - [CRM](https://support.didomi.io/integrations#crm)
- [Lexicon](https://support.didomi.io/lexicon)
- [Legal Requirements](https://support.didomi.io/legal-requirements#main-content)

    - [Didomi SDK compliance](https://support.didomi.io/legal-requirements#didomi-sdk-compliance)
- [Privacy Center and Data Processing](https://support.didomi.io/privacy-center-and-data-processing)
- [FAQ](https://support.didomi.io/faq#main-content)

    - [CMP / Managing tags](https://support.didomi.io/faq#cmp-managing-tags)
    - [CMP / Data Privacy for publishers](https://support.didomi.io/faq#cmp-data-privacy-for-publishers)
    - [CMP / Implementing a consent notice](https://support.didomi.io/faq#cmp-implementing-a-consent-notice)
    - [Debugging](https://support.didomi.io/faq#debugging)
    - [CMP / CPRA](https://support.didomi.io/faq#cmp-cpra)
    - [CMP / Analytics](https://support.didomi.io/faq#cmp-analytics)
    - [PMP](https://support.didomi.io/faq#pmp)
    - [Share consent](https://support.didomi.io/faq#share-consent)
    - [Customization](https://support.didomi.io/faq#customization)
    - [Cookies](https://support.didomi.io/faq#cookies)
    - [IAB](https://support.didomi.io/faq#iab)
- [Versions & Proofs](https://support.didomi.io/versions-proofs)
- [Login & Security](https://support.didomi.io/login-security#main-content)

    - [SSO](https://support.didomi.io/login-security#sso)
    - [Users, Teams and Permissions](https://support.didomi.io/login-security#users-teams-and-permissions)
- [Privacy Hub widget](https://support.didomi.io/privacy-hub-widget)
- [Consent Notices (old flow)](https://support.didomi.io/consent-notices-old-flow)
- [Consent Notices (NEW FLOW)](https://support.didomi.io/consent-notices-new-flow)
- [Customer Portal - Tickets](https://support.didomi.io/customer-portal-tickets)
- [Organization settings](https://support.didomi.io/organization-settings)
- [SDK version control](https://support.didomi.io/sdk-version-control)

Didomi, verb in ancient greek (δ‌‌ιδο‌μι): consent.

Copyright © 2026, Didomi SAS

Cookies