diff --git a/docs-site/docs/configuration.md b/docs-site/docs/configuration.md
index 312dfa1..f40fe60 100644
--- a/docs-site/docs/configuration.md
+++ b/docs-site/docs/configuration.md
@@ -45,7 +45,7 @@ execution:
   baseUrl: https://your-app.com
   gridUrl: http://localhost:4444   # only for remote mode
 
-  parallel: none            # none | methods | classes | tests
+  parallel: none            # none | methods | classes
   threadCount: 1            # ignored when parallel: none
   maxActiveSessions: 5      # max concurrent browser instances (semaphore)
 
@@ -181,14 +181,13 @@ Use `per-suite` when your suite has many sequential tests and browser startup ti
 ## Execution
 
 ### `parallel`
-Maps directly to TestNG parallel execution mode. Thread count is set via `threadCount`.
+Maps directly to TestNG parallel execution mode. Thread count is set via `threadCount`. Selenium Boot validates this value at suite bootstrap and rejects anything outside the three below — TestNG's `tests` mode is not currently accepted.
 
 | Value | Behaviour |
 |---|---|
 | `none` | Sequential execution (default) |
 | `methods` | Each `@Test` method runs in its own thread |
 | `classes` | Each test class runs in its own thread |
-| `tests` | Each `<test>` block in testng.xml runs in its own thread |
 
 ### `maxActiveSessions`
 Maximum concurrent browser instances. Tests wait (up to 30s) for a slot rather than failing immediately. Prevents resource exhaustion in parallel runs.
diff --git a/docs-site/docs/guides/parallel.md b/docs-site/docs/guides/parallel.md
index bddf3f5..da768af 100644
--- a/docs-site/docs/guides/parallel.md
+++ b/docs-site/docs/guides/parallel.md
@@ -17,7 +17,7 @@ Selenium Boot supports parallel test execution out of the box. Configure the thr
 ```yaml title="selenium-boot.yml"
 execution:
   mode: local
-  parallel: methods       # none (default) | methods | classes | tests
+  parallel: methods       # none (default) | methods | classes
   threadCount: 4          # number of concurrent browser sessions
   maxActiveSessions: 4    # semaphore cap — cannot exceed threadCount
 
@@ -85,13 +85,12 @@ You do not need to do anything special in your tests. `getDriver()` always retur
 
 ## Parallel modes
 
-TestNG supports several parallel modes. Selenium Boot works with all of them:
+TestNG supports several parallel modes. Selenium Boot currently validates `execution.parallel` against `none`, `methods`, and `classes` — any other value (including TestNG's `tests` mode) is rejected at suite bootstrap, before any test runs.
 
 | Mode | Description | Recommended |
 |---|---|---|
 | `methods` | Each test method runs in its own thread | Best general choice |
 | `classes` | Each test class runs in a thread | Use when tests within a class must be sequential |
-| `tests` | Each `<test>` tag in suite XML runs in a thread | For suite-level isolation |
 
 ---