SDK Compatibility Matrix
This topic describes the latest versions of the Optimizely SDKs and their available features.
Optimizely follows the Semantic Versioning standard when upgrading and releasing our SDKs and Clients. We are always working to add 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 application and SDK features may vary. The following tables lists cases where version support for features differ. For a complete version history of any given SDK, the changelogs on their Github repos remain the source of truth.
Client-side SDKs
| Feature * | Android | iOS (Swift) | JavaScript | Flutter | React | Objective-c (iOS) | Feature Release | Documentation |
|---|---|---|---|---|---|---|---|---|
| OptimizelyConfig V2 | 3.11+ | 3.9+ | 4.7+ | 1.0.1+ | 2.7+ | N/A | Sep 2021 | See topic for your language. For example, OptimizelyConfig |
| Decide, Create User Context and Track Event methods | 3.9+ | 3.7+ | 4.5+ | 1.0.1+ | 2.5+ | N/A | Feb 2021 | See Feature Experimentation documentation. |
| Numerical Audience >= and <= | 3.7+ | 3.5+ | 4.3+ | 1.0.1+ | 2.4+ | N/A | Oct 2020 | Target audiences |
| Version Audience Targeting | 3.7+ | 3.5+ | 4.3+ | 1.0.1+ | 2.4+ | N/A | Oct 2020 | Target audiences |
| Datafile Accessor | N/A | N/A | 3.7+ | 1.0.1+ | 2.3+ | N/A | Oct 2020 | See topic for your language, for example, OptimizelyConfig |
| JSON Feature Variables | 3.6+ | 3.4+ | 4.1+ | 1.0.1+ | 2.1+ | Swift Only | Jul 2020 | Create feature variables |
| Targeted Rollouts (per-audience configuration) | 2.0+ | 3.3.2+ | 2.0+ | 1.0.1+ | 1.0+ | 2.0+ | Jun 2020 | Introduction to rollouts |
| React Hooks | N/A | N/A | N/A | N/A | 2.0+ | N/A | May 2020 | See React SDK. |
| OptimizelyConfig API | 3.4+ | 3.2+ | 3.4+ | 1.0.1+ | 1.1+ | Swift Only | Feb 2020 | See OptimizelyConfig topic for your language. For example, OptimizelyConfig |
| Automatic Datafile Management | 1.0+ | 3.1+ | 3.2+ | 1.0.1+ | 1.0+ | 1.0+ | Jun 2019 | Datafile management FAQ |
| Easy Event Tracking | 3.0+ | 3.1+ | 3.0+ | 1.0.1+ | 1.0+ | 3.0+ | Feb 2019 | Introducing easy event tracking |
| Numerical Audience Targeting | 3.0+ | 3.1+ | 3.0+ | 1.0.1+ | 1.0+ | 3.0+ | Feb 2019 | Target audiences |
| Datafile Caching | 1.0+ | 3.1+ | N/A | 1.0.1+ | 2.2+ (React Native) | 1.0+ | Jul 2020 | See Initialize SDK topic for your language. For example, Initialize SDK |
| Offline Event Persistence | 1.0+ | 3.1+ | N/A | 1.0.1+ | 2.2+ (React Native) | 1.0+ | Jul 2020 | See Event Dispatcher topic for your language. For example, Configure event dispatcher |
*This compatibility matrix captures only noteworthy features released in April 2018 and later. For features released before April 2018, and for minor feature releases, see the changelog for your SDK in GitHub.
Server-side SDKs
| Feature * | Agent | C# | GO | Java | JavaScript (Node) | PHP | Python | Ruby | Feature Released | Documentation |
|---|---|---|---|---|---|---|---|---|---|---|
| OptimizelyConfigV2 | 2.5+ | 3.10+ | 1.7+ | 3.9+ | 4.7+ | 3.8+ | 3.10+ | 3.9+ | Sep 2021 | See topic for your language. For example, OptimizelyConfig |
| See Feature Experimentation documentation. | 2.4+ | 3.8+ | 1.6+ | 3.8+ | 4.5+ | 3.7+ | 3.8+ | 3.8+ | Feb 2021 | See Feature Experimentation documentation. |
| 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 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 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. For features released before April 2018, and for minor feature releases, see the changelog for your SDK in GitHub.
Current SDK versions
The current, stable SDK release is labeled Latest in GitHub, which is the source of truth and takes precedence over this document.
| SDK | Current release | Released |
|---|---|---|
| Agent | 4.0.0 | January 2024 |
| Android | 4.0.0 | January 2024 |
| C# | 4.0.0 | January 2024 |
| Flutter | 2.0.0 | January 2024 |
| Go | 2.0.0 | January 2024 |
| Java | 4.0.0 | January 2024 |
| Javascript (Browser), Javascript (Node) | 5.3.0 | April 2024 |
| PHP | 4.0.0 | June 2023 |
| Python | 5.0.0 | January 2024 |
| React, React Native | 3.1.0 | April 2024 |
| Ruby | 5.0.0 | January 2024 |
| Swift | 4.0.0 | January 2024 |
Updated 17 days ago