Dev guideAPI Reference
Dev guideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

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 *AndroidiOS (Swift)FlutterJavaScript (Browser)ReactFeature ReleaseDocumentation
Forced Decision methods3.13+3.10+1.0.14.9+2.8+Jan 2022See the Forced Decision method topic for your language. For example, Java.
OptimizelyConfig V23.11+3.9+1.0.14.7+2.7+Sep 2021See the topic for your language. For example, OptimizelyConfig.
Decide, Create User Context and Track Event methods3.9+3.7+1.0.14.5+2.5+Feb 2021See the Migrate from older versions topic for your language. For example, React.
Numerical Audience >= and <=3.7+3.5+1.0.14.3+2.4+Oct 2020Target audiences.
Version Audience Targeting3.7+3.5+1.0.14.3+2.4+Oct 2020Target audiences.
Datafile AccessorN/AN/A1.0.13.7+2.3+Oct 2020See the topic for your language, for example, OptimizelyConfig.
JSON Feature Variables3.6+3.4+1.0.14.1+2.1+Jul 2020Create flag variables.
Targeted Rollouts (per-audience config)2.0+3.3.2+1.0.12.0+1.0+Jun 2020See Migrate from older versions topic for your language, for example, Android.
OptimizelyConfig API3.4+3.2+1.0.13.4+1.1+Feb 2020See the OptimizelyConfig topic for your language. For example, OptimizelyConfig.
Automatic Datafile Management1.0+3.1+1.0.13.2+1.0+Jun 2019Manage config (datafile).
Numerical Audience Targeting3.0+3.1+1.0.13.0+1.0+Feb 2019Target audiences.
Datafile Caching1.0+3.1+1.0.1N/A2.2+ (React Native)Jul 2020See Initialize SDK topic for your language. For example, Initialize SDK.
Offline Event Persistence1.0+3.1+1.0.1N/A2.2+ (React Native)Jul 2020See 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 *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 the 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 the 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 flag variables
Targeted Rollouts (per-audience config)1.1+2.0+1.2+2.0+2.0+2.0+2.0+2.0+Jun 2020Run flag deliveries.
OptimizelyConfig API1.0+3.4+1.0+3.4+3.4+3.3+3.4+3.4+Feb 2020See the 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.
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. See the changelog for your SDK in GitHub for features released before April 2018 and minor feature releases.

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
Agent3.0.1March 2023
Android3.13.4March 2023
C#3.11.4July 2023
Flutter1.0.1May 2023
Go1.8.5October 2023
Java3.10.4June 2023
Javascript (Browser), Javascript (Node)4.10.0October 2023
PHP4.0.0June 2023
Python4.1.1March 2023
React, React Native2.9.2March 2023
Ruby4.0.1March 2023
Swift3.10.2March 2023