diff --git a/docs/src/test-api/class-testconfig.md b/docs/src/test-api/class-testconfig.md
index 89a16f1a10..69c10560b4 100644
--- a/docs/src/test-api/class-testconfig.md
+++ b/docs/src/test-api/class-testconfig.md
@@ -20,9 +20,9 @@ export default defineConfig({
 ## property: TestConfig.build
 * since: v1.35
 - type: ?<[Object]>
-  - `external` ?<[Array]<[string]>> Paths to exclude from the transpilation expressed as glob patterns. Typically heavy JS bundles your tests reference.
+  - `external` ?<[Array]<[string]>> Paths to exclude from the transpilation expressed as a list of glob patterns. Typically heavy JS bundles that your test uses are listed here.
 
-Transpiler configuration.
+Playwright transpiler configuration.
 
 **Usage**
 
@@ -31,7 +31,7 @@ import { defineConfig } from '@playwright/test';
 
 export default defineConfig({
   build: {
-    external: '**/*bundle.js',
+    external: ['**/*bundle.js'],
   },
 });
 ```
diff --git a/packages/playwright-test/types/test.d.ts b/packages/playwright-test/types/test.d.ts
index 58406fd65c..aab2e617b8 100644
--- a/packages/playwright-test/types/test.d.ts
+++ b/packages/playwright-test/types/test.d.ts
@@ -570,7 +570,7 @@ interface TestConfig {
    */
   webServer?: TestConfigWebServer | TestConfigWebServer[];
   /**
-   * Transpiler configuration.
+   * Playwright transpiler configuration.
    *
    * **Usage**
    *
@@ -580,7 +580,7 @@ interface TestConfig {
    *
    * export default defineConfig({
    *   build: {
-   *     external: '**\/*bundle.js',
+   *     external: ['**\/*bundle.js'],
    *   },
    * });
    * ```
@@ -588,8 +588,8 @@ interface TestConfig {
    */
   build?: {
     /**
-     * Paths to exclude from the transpilation expressed as glob patterns. Typically heavy JS bundles your tests
-     * reference.
+     * Paths to exclude from the transpilation expressed as a list of glob patterns. Typically heavy JS bundles that your
+     * test uses are listed here.
      */
     external?: Array<string>;
   };