diff --git a/docs/docs/development/new-shield.md b/docs/docs/development/new-shield.md
index d4bbf50e..76e237d5 100644
--- a/docs/docs/development/new-shield.md
+++ b/docs/docs/development/new-shield.md
@@ -115,18 +115,33 @@ endif
 
 ## Shield Overlays
 
-### Pro Micro Compatible Shields
+<Tabs
+defaultValue="pro_micro"
+values={[
+{label: 'Pro Micro Shields', value: 'pro_micro'},
+{label: 'BlackPill Shields', value: 'blackpill'},
+]}>
+
+<TabItem value="pro_micro">
+
+### Pro Micro Shields
 
 ![Labelled Pro Micro pins](../assets/pro-micro/pro-micro-pins-labelled.jpg)
 
 ZMK uses the blue color coded pin names to generate devicetree node references. For example, to refer to the node `0` in the devicetree files, use `&pro_micro 0`.
 
-### BlackPill Compatible Shields
+</TabItem>
+
+<TabItem value="blackpill">
+
+### BlackPill Shields
 
 ![Labelled BlackPill pins](../assets/blackpill/blackpill-pins-labelled.png)
 
 ZMK uses the blue color coded pin names to generate devicetree node references. For example, to refer to the node `17` in the devicetree files, use `&blackpill 17`.
 
+</TabItem>
+
 <Tabs
 defaultValue="unibody"
 values={[