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	React	Objective-c (iOS)	Feature Release	Documentation
Forced Decision methods	3.13+	3.10+	4.9+	2.8+	N/A	Jan 2022	See the Forced Decision method topic for your language. For example, Java
OptimizelyConfig V2	3.11+	3.9+	4.7+	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+	2.5+	N/A	Feb 2021	See the Migrate from older versions topic for your language. For example, React
Numerical Audience >= and <=	3.7+	3.5+	4.3+	2.4+	N/A	Oct 2020	Target audiences
Version Audience Targeting	3.7+	3.5+	4.3+	2.4+	N/A	Oct 2020	Target audiences
Datafile Accessor	N/A	N/A	3.7+	2.3+	N/A	Oct 2020	See topic for your language, for example, OptimizelyConfig
JSON Feature Variables	3.6+	3.4+	4.1+	2.1+	Swift Only	Jul 2020	Create feature variables
Targeted Rollouts (per-audience config)	2.0+	3.3.2+	2.0+	1.0+	2.0+	Jun 2020	See Migrate from older versions topic for your language, for example, Android
React Hooks	N/A	N/A	N/A	2.0+	N/A	May 2020	Introduction to rollouts
OptimizelyConfig API	3.4+	3.2+	3.4+	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.0+	Jun 2019	Datafile management FAQ
Easy Event Tracking	3.0+	3.1+	3.0+	1.0+	3.0+	Feb 2019	Introducing easy event tracking
Numerical Audience Targeting	3.0+	3.1+	3.0+	1.0+	3.0+	Feb 2019	Target audiences
Datafile Caching	1.0+	3.1+	N/A	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	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
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 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 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

Current SDK versions

SDK	Current release	Released
Agent	2.7.0	April 2022
Android	3.13.2	April 2022
C#	3.11.0	Jan 2022
Go	1.8.0	Jan 2022
Java	3.10.2	March 2022
Javascript (Browser), Javascript (Node)	4.9.1	Jan 2022
Objective C	3.1.5	Oct 2020
PHP	3.9.0	Jan 2022
Python	4.0.0	Jan 2022
React, React Native	2.8.1	March 2022
Ruby	3.10.0	Feb 2022
Swift	3.10.1	April 2022