diff --git a/core/src/components/toggle/usage/angular.md b/core/src/components/toggle/usage/angular.md
index ca3249257b..ec4f0f2462 100644
--- a/core/src/components/toggle/usage/angular.md
+++ b/core/src/components/toggle/usage/angular.md
@@ -1,6 +1,22 @@
 ```html
-<ion-list>
+<!-- Default Toggle -->
+<ion-toggle></ion-toggle>
 
+<!-- Disabled Toggle -->
+<ion-toggle disabled></ion-toggle>
+
+<!-- Checked Toggle -->
+<ion-toggle checked></ion-toggle>
+
+<!-- Toggle Colors -->
+<ion-toggle color="primary"></ion-toggle>
+<ion-toggle color="secondary"></ion-toggle>
+<ion-toggle color="danger"></ion-toggle>
+<ion-toggle color="light"></ion-toggle>
+<ion-toggle color="dark"></ion-toggle>
+
+<!-- Toggles in a List -->
+<ion-list>
   <ion-item>
     <ion-label>Pepperoni</ion-label>
     <ion-toggle [(ngModel)]="pepperoni"></ion-toggle>
@@ -15,6 +31,5 @@
     <ion-label>Mushrooms</ion-label>
     <ion-toggle [(ngModel)]="mushrooms"></ion-toggle>
   </ion-item>
-
 </ion-list>
 ```
diff --git a/core/src/components/toggle/usage/javascript.md b/core/src/components/toggle/usage/javascript.md
index d155da6b9d..b2372e720a 100644
--- a/core/src/components/toggle/usage/javascript.md
+++ b/core/src/components/toggle/usage/javascript.md
@@ -1,14 +1,21 @@
 ```html
+<!-- Default Toggle -->
 <ion-toggle></ion-toggle>
+
+<!-- Disabled Toggle -->
 <ion-toggle disabled></ion-toggle>
+
+<!-- Checked Toggle -->
 <ion-toggle checked></ion-toggle>
 
+<!-- Toggle Colors -->
 <ion-toggle color="primary"></ion-toggle>
 <ion-toggle color="secondary"></ion-toggle>
 <ion-toggle color="danger"></ion-toggle>
 <ion-toggle color="light"></ion-toggle>
 <ion-toggle color="dark"></ion-toggle>
 
+<!-- Toggles in a List -->
 <ion-list>
   <ion-item>
     <ion-label>Pepperoni</ion-label>