SDK Compatibility Matrix
This topic describes the latest versions of the Optimizely Feature Experimentation SDKs and their available features.
Optimizely Feature Experimentation follows the Semantic Versioning standard when upgrading and releasing our SDKs and Clients. We are always working on adding support for new SDKs and touchpoints, and we frequently enhance our existing SDKs to make them as idiomatic, performant and easy to use as possible.
As a result, the minimum version support for some applications and SDK features may vary. The following tables list cases where version support for features differs. For a complete version history of any given SDK, the changelogs on their GitHub repositories remain the source of truth.
Client-side SDKs
Feature * | Android | iOS (Swift) | Flutter | JavaScript (Browser) | React | Feature Release | Documentation |
---|---|---|---|---|---|---|---|
Advanced Audience Targeting | 4.0.0-beta2 | 4.0.0-beta | Coming soon | 5.0.0-beta | Coming soon | April 2023 | Advanced Audience Targeting is in beta – contact your Customer Success Manager for more information. |
Forced Decision methods | 3.13+ | 3.10+ | 1.0.1 | 4.9+ | 2.8+ | Jan 2022 | See the Forced Decision method topic for your language. For example, Java |
OptimizelyConfig V2 | 3.11+ | 3.9+ | 1.0.1 | 4.7+ | 2.7+ | Sep 2021 | See the topic for your language. For example, OptimizelyConfig |
Decide, Create User Context and Track Event methods | 3.9+ | 3.7+ | 1.0.1 | 4.5+ | 2.5+ | Feb 2021 | See the Migrate from older versions topic for your language. For example, React |
Numerical Audience >= and <= | 3.7+ | 3.5+ | 1.0.1 | 4.3+ | 2.4+ | Oct 2020 | Target audiences |
Version Audience Targeting | 3.7+ | 3.5+ | 1.0.1 | 4.3+ | 2.4+ | Oct 2020 | Target audiences |
Datafile Accessor | N/A | N/A | 1.0.1 | 3.7+ | 2.3+ | Oct 2020 | See the topic for your language, for example, OptimizelyConfig |
JSON Feature Variables | 3.6+ | 3.4+ | 1.0.1 | 4.1+ | 2.1+ | Jul 2020 | Create feature variables |
Targeted Rollouts (per-audience config) | 2.0+ | 3.3.2+ | 1.0.1 | 2.0+ | 1.0+ | Jun 2020 | See Migrate from older versions topic for your language, for example, Android |
React Hooks | N/A | N/A | N/A | N/A | 2.0+ | May 2020 | Introduction to rollouts |
OptimizelyConfig API | 3.4+ | 3.2+ | 1.0.1 | 3.4+ | 1.1+ | Feb 2020 | See the OptimizelyConfig topic for your language. For example, OptimizelyConfig |
Automatic Datafile Management | 1.0+ | 3.1+ | 1.0.1 | 3.2+ | 1.0+ | Jun 2019 | Datafile management FAQ |
Easy Event Tracking | 3.0+ | 3.1+ | 1.0.1 | 3.0+ | 1.0+ | Feb 2019 | Introducing easy event tracking |
Numerical Audience Targeting | 3.0+ | 3.1+ | 1.0.1 | 3.0+ | 1.0+ | Feb 2019 | Target audiences |
Datafile Caching | 1.0+ | 3.1+ | 1.0.1 | N/A | 2.2+ (React Native) | Jul 2020 | See Initialize SDK topic for your language. For example, Initialize SDK |
Offline Event Persistence | 1.0+ | 3.1+ | 1.0.1 | N/A | 2.2+ (React Native) | Jul 2020 | See the Event Dispatcher topic for your language. For example, Configure event dispatcher |
*This compatibility matrix captures only noteworthy features released in April 2018 and later. See the changelog for your SDK in GitHub for features released before April 2018 and minor feature releases.
Server-side SDKs
Feature * | Agent | C# | Go | Java | JavaScript (Node) | PHP | Python | Ruby | Feature Released | Documentation |
---|---|---|---|---|---|---|---|---|---|---|
Advanced Audience Targeting | 4.0.0-beta | 4.0.0-beta | 2.0.0-beta | 4.0.0-beta | 5.0.0-beta | Coming soon | 5.0.0-beta | 5.0.0-beta | April 2023 | Advanced Audience Targeting is in beta – contact your Customer Success Manager for more information. |
Forced Decision methods | 2.6+ | 3.11+ | 1.8+ | 3.10+ | 4.9+ | 3.9+ | 4.0+ | 3.10+ | Jan 2022 | See the Forced Decision method topic for your language. For example, Java |
OptimizelyConfigV2 | 2.5+ | 3.10+ | 1.7+ | 3.9+ | 4.7+ | 3.8+ | 3.10+ | 3.9+ | Sep 2021 | See the topic for your language. For example, OptimizelyConfig |
Decide, Create User Context, & Track Event methods | 2.4+ | 3.8+ | 1.6+ | 3.8+ | 4.5+ | 3.7+ | 3.8+ | 3.8+ | Feb 2021 | See the Migrate from older versions topic for your language. For example, Python |
Numerical Audience >= and <= | 2.1+ | 3.6+ | 1.4+ | 3.6+ | 4.3+ | 3.5+ | 3.6+ | 3.6+ | Oct 2020 | Target audiences |
Version Audience Targeting | 2.1+ | 3.6+ | 1.4+ | 3.6+ | 4.3+ | 3.5+ | 3.6+ | 3.6+ | Oct 2020 | Target audiences |
Datafile Accessor | N/A | 3.6+ | 1.4+ | 3.6+ | 4.3+ | 3.5+ | 3.6+ | 3.6+ | Oct 2020 | See the OptimizelyConfig topic for your language. For example, OptimizelyConfig |
JSON Feature Variables | 1.3+ | 3.5+ | 1.3+ | 3.5+ | 4.1+ | 3.4+ | 3.5+ | 3.5+ | Jul 2020 | Create feature variables |
Targeted Rollouts (per-audience config) | 1.1+ | 2.0+ | 1.2+ | 2.0+ | 2.0+ | 2.0+ | 2.0+ | 2.0+ | Jun 2020 | Introduction to rollouts |
OptimizelyConfig API | 1.0+ | 3.4+ | 1.0+ | 3.4+ | 3.4+ | 3.3+ | 3.4+ | 3.4+ | Feb 2020 | See the OptimizelyConfig topic for your language. For example, OptimizelyConfig |
Automatic Datafile Management | 1.0+ | 3.2+ | 1.0+ | 3.2+ | 3.2+ | 3.2+ | 3.2+ | 3.2+ | Jun 2019 | See Initialize SDK topic for your language. For example, Initialize SDK |
Easy Event Tracking | 1.0+ | 3.0+ | 1.0+ | 3.0+ | 3.0+ | 3.0+ | 3.0+ | 3.0+ | Feb 2019 | Introducing easy event tracking |
Numerical Audience Targeting | 1.0+ | 3.0+ | 1.0+ | 3.0+ | 3.0+ | 3.0+ | 3.0+ | 3.0+ | Feb 2019 | Target audiences |
*This compatibility matrix captures only noteworthy features released in April 2018 and later. See the changelog for your SDK in GitHub for features released before April 2018 and minor feature releases.
Current SDK versions
SDK | Current release | Released |
---|---|---|
Agent | 4.0.0-beta | May 2023 |
Android | 4.0.0-beta2 | May 2023 |
C# | 4.0.0-beta | May 2023 |
Flutter | 1.0.1 | May 2023 |
Go | 2.0.0-beta | April 2023 |
Java | 4.0.0-beta | May 2023 |
Javascript (Browser), Javascript (Node) | 5.0.0-beta | May 2023 |
Objective C | 3.1.5 | October 2020 |
PHP | 3.9.3 | March 2023 |
Python | 5.0.0-beta | April 2023 |
React, React Native | 2.9.2 | March 2023 |
Ruby | 5.0.0-beta | April 2023 |
Swift | 4.0.0-beta | May 2023 |
Updated 27 days ago