diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index a5280e6..50e17b3 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-	".": "2.1.0"
+	".": "2.1.1"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f4ef37d..5cb901e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,24 @@
 # Changelog
 
+## [2.1.1](https://github.com/dorixdev/react-dual-scroll-sync/compare/v2.1.0...v2.1.1) (2025-09-05)
+
+
+### 🐛 Bug Fixes
+
+* **context:** add maxVisibleItems to DualScrollSyncContextProps interface ([4c13328](https://github.com/dorixdev/react-dual-scroll-sync/commit/4c133289d9998124cce6ac40349587f43b18ea2d))
+* **DualScrollSync:** add maxVisibleItems support with docs and tests ([#27](https://github.com/dorixdev/react-dual-scroll-sync/issues/27)) ([4c13328](https://github.com/dorixdev/react-dual-scroll-sync/commit/4c133289d9998124cce6ac40349587f43b18ea2d))
+* **DualScrollSync:** ensure maxVisibleItems is correctly passed from context ([4c13328](https://github.com/dorixdev/react-dual-scroll-sync/commit/4c133289d9998124cce6ac40349587f43b18ea2d))
+
+
+### 📝 Documentation
+
+* **README:** update usage patterns and examples for DualScrollSync component ([4c13328](https://github.com/dorixdev/react-dual-scroll-sync/commit/4c133289d9998124cce6ac40349587f43b18ea2d))
+
+
+### ✅ Tests
+
+* **DualScrollSyncNav:** update tests to use context mock for maxVisibleItems ([4c13328](https://github.com/dorixdev/react-dual-scroll-sync/commit/4c133289d9998124cce6ac40349587f43b18ea2d))
+
 ## [2.1.0](https://github.com/dorixdev/react-dual-scroll-sync/compare/v2.0.2...v2.1.0) (2025-09-05)
 
 
diff --git a/package.json b/package.json
index ab72992..5eab3d2 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "@dorixdev/react-dual-scroll-sync",
-	"version": "2.1.0",
+	"version": "2.1.1",
 	"license": "MIT",
 	"description": "A lightweight React library to synchronize navigation menus with scrollable content sections.",
 	"type": "module",