diff --git a/README.md b/README.md
index c3d9ed4..e6e3ba0 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,9 @@ Add the required dev dependencies to your project (use your preferred package ma
 npm i -D @oxctl/deployment-test-utils @playwright/test dotenv
 ```
 
+> [!NOTE] 
+> Playwright 1.58.0 introduced a [bug](https://github.com/microsoft/playwright/issues/39172) that causes duplicate test title errors. This version of the library constrains Playwright to <1.58.0 to avoid this issue, but if you are using a later version of Playwright in your project, you may need to adjust the version in your `package.json` to avoid conflicts.
+
 Optionally install Playwright browser binaries (if you haven't already):
 
 ```bash
diff --git a/package-lock.json b/package-lock.json
index 5683fd9..4f53734 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -13,7 +13,7 @@
         "vite": "6.4.1"
       },
       "peerDependencies": {
-        "@playwright/test": "^1.55.1",
+        "@playwright/test": ">=1.36.0 <1.58.0",
         "dotenv": "^16.3.1"
       }
     },
diff --git a/package.json b/package.json
index 1d69b58..2cd7f76 100644
--- a/package.json
+++ b/package.json
@@ -33,7 +33,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@playwright/test": "^1.55.1",
+    "@playwright/test": ">=1.36.0 <1.58.0",
     "dotenv": "^16.3.1"
   },
   "peerDependencyMeta": {