Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySumbit a ticketLog In
GitHubNuGetDev CommunitySumbit a ticket

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 *AndroidiOS (Swift)JavaScriptFlutterReactObjective-c (iOS)Feature ReleaseDocumentation
OptimizelyConfig V23.11+3.9+4.7+1.0.1+2.7+N/ASep 2021See topic for your language. For example, OptimizelyConfig
Decide, Create User Context and Track Event methods3.9+3.7+4.5+1.0.1+2.5+N/AFeb 2021See Feature Experimentation documentation.
Numerical Audience >= and <=3.7+3.5+4.3+1.0.1+2.4+N/AOct 2020Target audiences
Version Audience Targeting3.7+3.5+4.3+1.0.1+2.4+N/AOct 2020Target audiences
Datafile AccessorN/AN/A3.7+1.0.1+2.3+N/AOct 2020See topic for your language, for example, OptimizelyConfig
JSON Feature Variables3.6+3.4+4.1+1.0.1+2.1+Swift OnlyJul 2020Create feature variables
Targeted Rollouts (per-audience configuration)2.0+3.3.2+2.0+1.0.1+1.0+2.0+Jun 2020Introduction to rollouts
React HooksN/AN/AN/AN/A2.0+N/AMay 2020See React SDK.
OptimizelyConfig API3.4+3.2+3.4+1.0.1+1.1+Swift OnlyFeb 2020See OptimizelyConfig topic for your language. For example, OptimizelyConfig
Automatic Datafile Management1.0+3.1+3.2+1.0.1+1.0+1.0+Jun 2019Datafile management FAQ
Easy Event Tracking3.0+3.1+3.0+1.0.1+1.0+3.0+Feb 2019Introducing easy event tracking
Numerical Audience Targeting3.0+3.1+3.0+1.0.1+1.0+3.0+Feb 2019Target audiences
Datafile Caching1.0+3.1+N/A1.0.1+2.2+ (React Native)1.0+Jul 2020See Initialize SDK topic for your language. For example, Initialize SDK
Offline Event Persistence1.0+3.1+N/A1.0.1+2.2+ (React Native)1.0+Jul 2020See 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 *AgentC#GOJavaJavaScript (Node)PHPPythonRubyFeature ReleasedDocumentation
OptimizelyConfigV22.5+3.10+1.7+3.9+4.7+3.8+3.10+3.9+Sep 2021See 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 2021See Feature Experimentation documentation.
Numerical Audience >= and <=2.1+3.6+1.4+3.6+4.3+3.5+3.6+3.6+Oct 2020Target audiences
Version Audience Targeting2.1+3.6+1.4+3.6+4.3+3.5+3.6+3.6+Oct 2020Target audiences
Datafile AccessorN/A3.6+1.4+3.6+4.3+3.5+3.6+3.6+Oct 2020See OptimizelyConfig topic for your language. For example, OptimizelyConfig
JSON Feature Variables1.3+3.5+1.3+3.5+4.1+3.4+3.5+3.5+Jul 2020Create feature variables
Targeted Rollouts (per-audience config)1.1+2.0+1.2+2.0+2.0+2.0+2.0+2.0+Jun 2020Introduction to rollouts
OptimizelyConfig API1.0+3.4+1.0+3.4+3.4+3.3+3.4+3.4+Feb 2020See OptimizelyConfig topic for your language. For example, OptimizelyConfig
Automatic Datafile Management1.0+3.2+1.0+3.2+3.2+3.2+3.2+3.2+Jun 2019See Initialize SDK topic for your language. For example, Initialize SDK
Easy Event Tracking1.0+3.0+1.0+3.0+3.0+3.0+3.0+3.0+Feb 2019Introducing easy event tracking
Numerical Audience Targeting1.0+3.0+1.0+3.0+3.0+3.0+3.0+3.0+Feb 2019Target 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.

SDKCurrent releaseReleased
Agent4.0.0January 2024
Android4.0.0January 2024
C#4.0.0January 2024
Flutter2.0.0January 2024
Go2.0.0January 2024
Java4.0.0January 2024
Javascript (Browser), Javascript (Node)5.0.1February 2024
PHP4.0.0June 2023
Python5.0.0January 2024
React, React Native3.0.0January 2024
Ruby5.0.0January 2024
Swift4.0.0January 2024