feat: custom bucketing seed

Author: Kaustubh22327

CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.20.0] - 2026-03-03
+
+### Added
+
+- Added support for `customBucketingSeed` in context to specify the seed for bucketing.
+
+```python
+options = {
+  'sdk_key': '32-alpha-numeric-sdk-key',
+  'account_id': '123456',
+}
+
+vwo_client = init(options)
+
+# Pass customBucketingSeed in context
+user_context = {
+    'id': 'unique_user_id',
+    'bucketingSeed': 'group_id_123'
+}
+
+get_flag = vwo_client.get_flag('feature_key', user_context)
+```
 ## [1.19.0] - 2026-02-17
 
 - Added support to use the context `id` as the visitor UUID instead of auto-generating one. You can read the visitor UUID from the flag result via `flag.get_uuid()` (e.g. to pass to the web client).

README.md

@@ -633,6 +633,33 @@ You can also manually flush events using the `flush_events()` method:
 vwo_client.flush_events()
 ```
 
+
+### Custom Bucketing Seed
+
+This option allows you to override the default bucketing behavior (which uses `userId`) and specify a custom seed for bucketing users into variations. This is useful when you want to ensure consistent variation assignments across different user IDs (e.g., maintaining the same experience for a group of users).
+
+To use this feature, provide the `bucketingSeed` in the user context.
+
+```python
+from vwo import init
+
+options = {
+    'sdk_key': '32-alpha-numeric-sdk-key', # SDK Key
+    'account_id': '123456', # VWO Account ID
+}
+
+vwo_client = init(options)
+
+# Pass bucketingSeed in context
+user_context = {
+    'id': 'unique_user_id',
+    'bucketingSeed': 'group_id_123' # This value will be used for bucketing
+}
+
+# The user will be bucketed based on 'group_id_123' instead of 'unique_user_id'
+get_flag = vwo_client.get_flag('feature_key', user_context)
+```
+
 ## Local development
 
 ```bash

setup.py

@@ -121,7 +121,7 @@ def run(self):
 
 setup(
     name="vwo-fme-python-sdk",
-    version="1.19.0",
+    version="1.20.0",
     description="VWO Feature Management and Experimentation SDK for Python",
     long_description=long_description,
     long_description_content_type="text/markdown",