diff --git a/src/components/navbar/navbar.ts b/src/components/navbar/navbar.ts
index 6bbc656fe5..f82e8b3b46 100644
--- a/src/components/navbar/navbar.ts
+++ b/src/components/navbar/navbar.ts
@@ -66,6 +66,8 @@ class ToolbarBackground {
  * button. A navbar can contain a `ion-title`, any number of buttons,
  * a segment, or a searchbar. Navbars must be placed within an
  * `<ion-header>` in order for them to be placed above the content.
+ * It's important to note that navbar's are part of the dynamica navigation
+ * stack. If you need a static toolbar, use ion-toolbar.
  *
  * @usage
  * ```html