diff --git a/docs/api/badge.md b/docs/api/badge.md
index 21e2f298355..631295e274d 100644
--- a/docs/api/badge.md
+++ b/docs/api/badge.md
@@ -17,7 +17,7 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill';
-Badges are inline block elements that usually appear near another element. Typically they contain a number or other characters. They can be used as a notification that there are additional items associated with an element and indicate how many items there are.
+Badges are inline block elements that usually appear near another element. Typically they contain a number or other characters. They can be used as a notification that there are additional items associated with an element and indicate how many items there are. Badges are hidden if no content is passed in.
## Basic Usage
diff --git a/versioned_docs/version-v6/api/badge.md b/versioned_docs/version-v6/api/badge.md
index 202b2f32878..18920b542c9 100644
--- a/versioned_docs/version-v6/api/badge.md
+++ b/versioned_docs/version-v6/api/badge.md
@@ -21,7 +21,7 @@ import EncapsulationPill from '@components/page/api/EncapsulationPill';
-Badges are inline block elements that usually appear near another element. Typically they contain a number or other characters. They can be used as a notification that there are additional items associated with an element and indicate how many items there are.
+Badges are inline block elements that usually appear near another element. Typically they contain a number or other characters. They can be used as a notification that there are additional items associated with an element and indicate how many items there are. Badges are hidden if no content is passed in.
## Basic Usage