diff --git a/ionic/components/switch/switch.ts b/ionic/components/switch/switch.ts
index af7944b222..644ca18e37 100644
--- a/ionic/components/switch/switch.ts
+++ b/ionic/components/switch/switch.ts
@@ -39,7 +39,10 @@ class MediaSwitch {
  * Switches can also have colors assigned to them, by adding any color attribute to them.
  *
  * See the [Angular 2 Docs](https://angular.io/docs/js/latest/api/forms/) for more info on forms and input.
- *
+ * @property {any} [value] - the inital value of the switch
+ * @property {boolean} [checked] - whether the switch it toggled or not
+ * @property {boolean} [disabled] - whether the switch is disabled or not
+ * @property {string} [id] - a unique ID for a switch
  * @usage
  * ```html
  * // Create a single switch