diff --git a/GUIDE.md b/GUIDE.md
index b12b115..52a7928 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -362,3 +362,13 @@ Then attach it to a `button` or `a` element by passing in the name of the templa
 ```
 <button data-ion-modal="myModal">Open Modal</button>
 ```
+
+## Popups
+
+You show alerts using the `ionPopup` component. This can be done as follows:
+
+```
+IonPopup.alert({title: 'title', subTitle: 'subTitle'});
+```
+
+You can also use `IonPopup.confirm({})`, `IonPopup.prompt({})` and `IonPopup.close()`.
\ No newline at end of file