diff --git a/demos/icon/index.ts b/demos/icon/index.ts
new file mode 100644
index 0000000000..405e893db7
--- /dev/null
+++ b/demos/icon/index.ts
@@ -0,0 +1,6 @@
+import {App} from 'ionic/ionic';
+
+@App({
+ templateUrl: 'main.html'
+})
+class ApiDemoApp {}
diff --git a/demos/icon/main.html b/demos/icon/main.html
new file mode 100644
index 0000000000..7897a7aee8
--- /dev/null
+++ b/demos/icon/main.html
@@ -0,0 +1,71 @@
+
+ Icon
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/ionic/components/icon/icon.ts b/ionic/components/icon/icon.ts
index 7b4f3ce000..7f821d867d 100644
--- a/ionic/components/icon/icon.ts
+++ b/ionic/components/icon/icon.ts
@@ -38,6 +38,7 @@ import {Config} from '../../config/config';
* inactive icon on iOS will use an outlined version of the icon same icon.
* Material Design icons do not change appearance depending if they're active
* or not. The `isActive` property is largely used by the tabbar.
+ * @demo /docs/v2/demos/icon/
* @see {@link /docs/v2/components#icons Icon Component Docs}
*
*/