diff --git a/core/src/components/toggle/readme.md b/core/src/components/toggle/readme.md
index 3dfafba9fa..13046f3267 100644
--- a/core/src/components/toggle/readme.md
+++ b/core/src/components/toggle/readme.md
@@ -3,42 +3,6 @@
 Toggles change the state of a single option. Toggles can be switched on or off by pressing or swiping them. They can also be checked programmatically by setting the `checked` property.
 
 
-```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>
-    <ion-toggle slot="end" value="pepperoni" checked></ion-toggle>
-  </ion-item>
-
-  <ion-item>
-    <ion-label>Sausage</ion-label>
-    <ion-toggle slot="end" value="sausage" disabled></ion-toggle>
-  </ion-item>
-
-  <ion-item>
-    <ion-label>Mushrooms</ion-label>
-    <ion-toggle slot="end" value="mushrooms"></ion-toggle>
-  </ion-item>
-</ion-list>
-```
-
 
 <!-- Auto Generated Below -->
 
diff --git a/core/src/components/toggle/toggle.tsx b/core/src/components/toggle/toggle.tsx
index 0b9e7ca53b..50c2241f90 100644
--- a/core/src/components/toggle/toggle.tsx
+++ b/core/src/components/toggle/toggle.tsx
@@ -27,14 +27,12 @@ export class Toggle implements CheckboxInput {
   /**
    * The color to use from your Sass `$colors` map.
    * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
-   * For more information, see [Theming your App](/docs/theming/theming-your-app).
    */
   @Prop() color?: Color;
 
   /**
    * The mode determines which platform styles to use.
    * Possible values are: `"ios"` or `"md"`.
-   * For more information, see [Platform Styles](/docs/theming/platform-specific-styles).
    */
   @Prop() mode!: Mode;
 
diff --git a/core/src/components/toggle/usage/angular.md b/core/src/components/toggle/usage/angular.md
new file mode 100644
index 0000000000..ca3249257b
--- /dev/null
+++ b/core/src/components/toggle/usage/angular.md
@@ -0,0 +1,20 @@
+```html
+<ion-list>
+
+  <ion-item>
+    <ion-label>Pepperoni</ion-label>
+    <ion-toggle [(ngModel)]="pepperoni"></ion-toggle>
+  </ion-item>
+
+  <ion-item>
+    <ion-label>Sausage</ion-label>
+    <ion-toggle [(ngModel)]="sausage" disabled="true"></ion-toggle>
+  </ion-item>
+
+  <ion-item>
+    <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
new file mode 100644
index 0000000000..d155da6b9d
--- /dev/null
+++ b/core/src/components/toggle/usage/javascript.md
@@ -0,0 +1,28 @@
+```html
+<ion-toggle></ion-toggle>
+<ion-toggle disabled></ion-toggle>
+<ion-toggle checked></ion-toggle>
+
+<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>
+
+<ion-list>
+  <ion-item>
+    <ion-label>Pepperoni</ion-label>
+    <ion-toggle slot="end" value="pepperoni" checked></ion-toggle>
+  </ion-item>
+
+  <ion-item>
+    <ion-label>Sausage</ion-label>
+    <ion-toggle slot="end" value="sausage" disabled></ion-toggle>
+  </ion-item>
+
+  <ion-item>
+    <ion-label>Mushrooms</ion-label>
+    <ion-toggle slot="end" value="mushrooms"></ion-toggle>
+  </ion-item>
+</ion-list>
+```