diff --git a/js/angular/service/modal.js b/js/angular/service/modal.js
index ad5aa753750..b95ef007d3f 100644
--- a/js/angular/service/modal.js
+++ b/js/angular/service/modal.js
@@ -4,7 +4,8 @@
  * @module ionic
  * @description
  * The Modal is a content pane that can go over the user's main view
- * temporarily.  Usually used for making a choice or editing an item.
+ * temporarily.  Usually used for making a choice or editing an item. 
+ * Note that you need to put the content of the modal inside a div with the class `modal`.
  *
  * @usage
  * ```html