diff --git a/docs/source/docs/border-color.blade.md b/docs/source/docs/border-color.blade.md
index 4ab869df3..6426f50fa 100644
--- a/docs/source/docs/border-color.blade.md
+++ b/docs/source/docs/border-color.blade.md
@@ -40,3 +40,37 @@ Hover utilities can also be combined with responsive utilities by adding the res
 ```html
 <button class="... md:border-blue md:hover:border-red ...">Button</button>
 ```
+
+## Customizing
+
+### Responsive, Hover, and Focus Variants
+
+By default, no focus, or group-hover variants are generated for border color utilities.
+
+You can control which variants are generated for the border color utilities by modifying the `borderColors` property in the `modules` section of your Tailwind config file.
+
+For example, this config will _also_ generate focus variants:
+
+```js
+{
+    // ...
+    modules: { 
+        // ...
+        borderColors: ['responsive', 'hover', 'focus'],
+    }
+}
+```
+
+### Disabling
+
+If you aren't using the border color utilities in your project, you can disable them entirely by setting the `borderColors` property to `false` in the `modules` section of your config file:
+
+```js
+{
+    // ...
+    modules: {
+        // ...
+        borderColors: false,
+    }
+}
+```