Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In

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
Forced Decision methods3.13+3.10+4.9+1.0.1+2.8+N/AJan 2022See the Forced Decision method topic for your language. For example, Java
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 the Migrate from older versions topic for your language. For example, React
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 config)2.0+3.3.2+2.0+1.0.1+1.0+2.0+Jun 2020See Migrate from older versions topic for your language, for example, Android
React HooksN/AN/AN/AN/A2.0+N/AMay 2020Introduction to rollouts
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
Forced Decision methods2.6+3.11+1.8+3.10+4.9+3.9+4.0+3.10+Jan 2022See the Forced Decision method topic for your language. For example, Java
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
Decide, Create User Context, & Track Event methods2.4+3.8+1.6+3.8+4.5+3.7+3.8+3.8+Feb 2021See 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 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

SDKCurrent releaseReleased
Agent3.0.0March 2023
Android3.13.4March 2023
C#3.11.2March 2023
Flutter1.0.1May 2023
Go1.8.4March 2023
Java3.10.3March 2023
Javascript (Browser), Javascript (Node)4.9.3March 2023
Objective C3.1.5October 2020
PHP3.9.3March 2023
Python4.1.1March 2023
React, React Native2.9.2March 2023
Ruby4.0.1March 2023
Swift3.10.2March 2023