diff --git a/src/@ionic-native/plugins/screen-orientation/index.ts b/src/@ionic-native/plugins/screen-orientation/index.ts
index 5800d9727..1dd252677 100644
--- a/src/@ionic-native/plugins/screen-orientation/index.ts
+++ b/src/@ionic-native/plugins/screen-orientation/index.ts
@@ -26,8 +26,16 @@ import { Observable } from 'rxjs/Observable';
  *
  * // allow user rotate
  * this.screenOrientation.unlock();
- * ```
  *
+ * // detect orientation changes
+ * this.screenOrientation.onChange().subscribe(
+ *    () => {
+ *        console.log("Orientation Changed");
+ *    }
+ * );
+ *
+ * ```
+ * 
  * @advanced
  *
  * Accepted orientation values: