GuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityLog In

SDK Compatibility Matrix

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

*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

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


Did this page help you?