---
updatedAt: 2026-09-17T16:36:47.000Z
agentTools:
projectIndex: https://docs.developers.convert.com/llms.txt
---
# JavaScript SDK
## JavaScript SDK v5.0.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v5.0.2)
### New Features and Improvements
* **Enhanced Attribute Forwarding:**
* Forward all per-call bucketing attributes on feature entry points, improving flexibility and automation.
* [Commit 57ee408](https://github.com/convertcom/javascript-sdk/commit/57ee4081f16e7552c61d0ea34a5625231973b44a)
* **Experience Keys for Feature Control:**
* Utilize experienceKeys to refine feature execution with `runFeatures`, enabling more targeted control.
* [Commit e826055](https://github.com/convertcom/javascript-sdk/commit/e8260551dbcd1f7a6ae925ea0b0e036218af4e5a)
### Bug Fixes
* **Consistent Attribute Forwarding:**
* Ensure all per-call bucketing attributes are consistently forwarded on feature entry points.
* [Commit ae60d19](https://github.com/convertcom/javascript-sdk/commit/ae60d19bda638c5a3da686f6ad568d99fffa02ea)
***
## JavaScript SDK v5.0.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v5.0.1)
### New Features and Improvements
* **Update TypeScript Plugin Version**
* Upgraded `rollup-plugin-typescript2` to version 0.37. This includes updating to `picomatch` 2.3.2, which can improve pattern matching performance. [Commit](https://github.com/convertcom/javascript-sdk/commit/15633daef67aeb13f4f8f0b48b4d3e9df3c30264)
### Bug Fixes
* **Remove Peer Dependency Noise**
* Eliminated unnecessary peerDependency changes in build diffs, reducing clutter and simplifying version control reviews. [Commit](https://github.com/convertcom/javascript-sdk/commit/4b6bbdda5059bc6d9b4163f8a0bbc7e613c6e5ea)
***
## JavaScript SDK v5.0.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v5.0.0)
### New Features and Improvements
* **New Anchored Bucketing Layout**
* The bucketing layout is now selected by `experience.version`. Experiences with version > 11 use the new anchored layout, offering improved distribution logic over the old packed cumulative walk approach. [See commit](https://github.com/convertcom/javascript-sdk/commit/03bfb5ef5d0568658d985ed962dd8f36d5d62214).
* **Anchored Layout Reference Implementation**
* The JavaScript SDK now includes a reference implementation for the anchored layout as defined in contract v12. [See commit](https://github.com/convertcom/javascript-sdk/commit/24ec631373d969c47a33d3c94334dd22cbc50699).
* **Full Stack v12 Enhancements**
* Introduced features for safer traffic ramp-up, variation preview, and experiment exclusion, enhancing the flexibility and safety of experiment management. [See commit](https://github.com/convertcom/javascript-sdk/commit/a0f4ac4f1583b435323fd43947a21f616343d67c).
* **Mutual-Exclusion Audience Rule**
* Added a new audience rule for mutual exclusion based on `bucketed_into_experience_key`, allowing for more precise targeting and exclusion logic. [See commit](https://github.com/convertcom/javascript-sdk/commit/fc54dc07f2346b933f2abefd3c9c7ec266f467eb).
* **Zero-Trace Location Events**
* Implemented zero-trace location events and encoded config-fetch parameters to enhance the privacy and security of API interactions. [See commit](https://github.com/convertcom/javascript-sdk/commit/0cf6a10e07050e7a093db500173e61756c7d2286).
* **Force Preview Target in runExperiences()**
* The SDK now supports forcing the preview target in `runExperiences()` to achieve parity with run-all functionality, ensuring consistent behavior during previews. [See commit](https://github.com/convertcom/javascript-sdk/commit/a19840d1deeb8882f6048b0f86cdb19ab1cdea9b).
***
## JavaScript SDK v4.4.3
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.4.3)
#### Bug Fixes
* ****js-sdk:** pick up Web:** **js-sdk:** pick up Web Worker runtime detection fix from js-sdk-utils
***
## JavaScript SDK v4.4.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.4.2)
#### Bug Fixes
* ****js-sdk:** document ConvertAgent UA:** **js-sdk:** document ConvertAgent UA invariant (trigger js-sdk release)
* ****js-sdk:** document ConvertAgent User-Agent:** **js-sdk:** document ConvertAgent User-Agent invariant on server-side HTTP, closes [#387](https://github.com/convertcom/javascript-sdk/issues/387)
***
## JavaScript SDK v4.4.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.4.1)
#### Bug Fixes
* ****context:** forward all BucketingAttributes:** **context:** forward all BucketingAttributes to ExperienceManager
***
## JavaScript SDK v4.4.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.4.0)
#### New Features and Improvements
* **Replace Karma with Playwright:** Replace Karma with Playwright and add full-chain integration tests
***
## JavaScript SDK v4.3.4
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.3.4)
#### Bug Fixes
* **Properly short-circuit AND logic:** Properly short-circuit AND logic to return RuleError instead of false
***
## JavaScript SDK v4.3.3
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.3.3)
#### Bug Fixes
* **Expose "data" property**
* **Improve numeric check utility**
***
## JavaScript SDK v4.3.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.3.2)
#### Bug Fixes
* **Updating npm config**
***
## JavaScript SDK v4.3.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.3.1)
#### Bug Fixes
* **Expose "data" property**
***
## JavaScript SDK v4.3.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.3.0)
#### New Features and Improvements
* **Handle audience matching options:** Handle audience matching options "any/all"
***
## JavaScript SDK v4.2.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.2.2)
#### Bug Fixes
* **Environment endpoints**
***
## JavaScript SDK v4.2.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.2.1)
#### Bug Fixes
* **Handle forced variation**
***
## JavaScript SDK v4.2.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.2.0)
#### New Features and Improvements
* **Promisify Context.releaseQueues()**
***
## JavaScript SDK v4.1.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.1.0)
#### New Features and Improvements
* **Allow multiple transactions on:** Allow multiple transactions on tracking revenue goal
* **Generate rollup config per:** Generate rollup config per package
* **Implement SDK Key/Secret with:** Implement SDK Key/Secret with Authorization Bearer header
* **Introduce BucketingError when deciding:** Introduce BucketingError when deciding variations
* **Introduce Context.getVisitorData()**
* **Return bucketing allocation upon:** Return bucketing allocation upon deciding variation
#### Bug Fixes
* **Resolve missing dependencies for:** Resolve missing dependencies for type declarations
* **Update the shape of:** Update the shape of goalData for tracking revenue
***
## JavaScript SDK v4.0.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.0.1)
#### Bug Fixes
* **Include all visitor data:** Include all visitor data in persistence dataStore if provided
***
## JavaScript SDK v4.0.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v4.0.0)
#### ⚠ BREAKING CHANGES
* **Use generated API config:** Use generated API config types to match the published specs at
#### New Features and Improvements
* **Use generated API config:** Use generated API config types to match the published specs at
***
## JavaScript SDK v3.0.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v3.0.0)
#### ⚠ BREAKING CHANGES
* **Include experience key hash:** Include experience key hash bucketing
#### New Features and Improvements
* **Include experience key hash:** Include experience key hash bucketing
#### Bug Fixes
* **More robust utility for:** More robust utility for checking plain object
***
## JavaScript SDK v2.4.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.4.1)
#### Bug Fixes
* **Expose VariationChange, VariationChangeType, and:** Expose VariationChange, VariationChangeType, and FullStackFeatureChang
***
## JavaScript SDK v2.4.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.4.0)
#### New Features and Improvements
* **Introduce "Context.getConfigEntityById()"**
***
## JavaScript SDK v2.3.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.3.0)
#### New Features and Improvements
* **Introduce Context.releaseQueues() that sends:** Introduce Context.releaseQueues() that sends pending API/DataStore queues to server
***
## JavaScript SDK v2.2.4
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.2.4)
#### Bug Fixes
* **Handle undefined default visitor:** Handle undefined default visitor properties
***
## JavaScript SDK v2.2.3
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.2.3)
#### Bug Fixes
* **Ignore extended properties when:** Ignore extended properties when firing events by the EventManager
***
## JavaScript SDK v2.2.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.2.2)
#### Bug Fixes
* **Case-insensitive "equal" and "matches":** Case-insensitive "equal" and "matches" comparisons
***
## JavaScript SDK v2.2.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.2.1)
#### Bug Fixes
* **Less/lessEqual comparison negation logic**
***
## JavaScript SDK v2.2.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.2.0)
#### New Features and Improvements
* **Adding optional property for:** Adding optional property for deciding whether to send tracking event upon bucketing visitors when using ExperiencManager directly
#### Bug Fixes
* **Gracefully handle config server-side:** Gracefully handle config server-side errors
***
## JavaScript SDK v2.1.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.1.0)
#### New Features and Improvements
* **Introduce Context.updateVisitorProperties and Context.getConfigEntity**
* **Optionally update in-memory visitorProperties:** Optionally update in-memory visitorProperties on running experience(s)/feature(s)
#### Bug Fixes
* **Always include report segments:** Always include report segments with visitorProperties for rule matching
* **Filter report segments on:** Filter report segments on Context.setDefaultSegments
* **Rename Context.setCustomSegments to Context.runCustomSegments**
***
## JavaScript SDK v2.0.3
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.0.3)
#### Bug Fixes
* **Require either SDk Key:** Require either SDk Key or data for initializing config
***
## JavaScript SDK v2.0.2
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.0.2)
#### Bug Fixes
* **Support edge runtime**
***
## JavaScript SDK v2.0.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.0.1)
#### Bug Fixes
* **Correct types declarations at:** Correct types declarations at built time
***
## JavaScript SDK v2.0.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v2.0.0)
#### ⚠ BREAKING CHANGES
* **Extract js-sdk-api, js-sdk-rule, js-sdk-bucketing:** Extract js-sdk-api, js-sdk-rule, js-sdk-bucketing, js-sdk-event, js-sdk-data, js-sdk-experience, js-sdk-segments, js-sdk-logger, js-sdk-enums, js-sdk-types, and js-sdk-utils as peer dependencies
#### Code Refactoring
* **Extract js-sdk-api, js-sdk-rule, js-sdk-bucketing:** Extract js-sdk-api, js-sdk-rule, js-sdk-bucketing, js-sdk-event, js-sdk-data, js-sdk-experience, js-sdk-segments, js-sdk-logger, js-sdk-enums, js-sdk-types, and js-sdk-utils as peer dependencies
***
## JavaScript SDK v1.2.1
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v1.2.1)
#### Bug Fixes
* **Allow optional environment per:** Allow optional environment per experience when bucketing visitors
* **Handle the case of:** Handle the case of no audience restrictions when bucketing visitors
* **Only show invalid dataStore:** Only show invalid dataStore error when provided
* **Skip tracking conversion event:** Skip tracking conversion event if goal already triggered
***
## JavaScript SDK v1.2.0
> [View on GitHub](https://github.com/convertcom/javascript-sdk/releases/tag/js-sdk-v1.2.0)
#### New Features and Improvements
* **Initial SDK release**
#### New Features and Improvements
* **Initial SDK release**