diff --git a/addons/rose/addon/components/rose/badge/index.stories.mdx b/addons/rose/addon/components/rose/badge/index.stories.mdx
index 5e1af6f8c..83eb3c6d8 100644
--- a/addons/rose/addon/components/rose/badge/index.stories.mdx
+++ b/addons/rose/addon/components/rose/badge/index.stories.mdx
@@ -3,7 +3,45 @@ import { hbs } from 'ember-cli-htmlbars';
-# Badge
+# HDS Badge (Recommended)
+
+> **_NOTE:_** Replaces the deprecated Rose/Badge.
+
+```handlebars
+
+```
+
+Refer to the [HDS Badge documentation](https://design-system-components-hashicorp.vercel.app/components/badge) for a complete overview
+
+export const HDSTemplate = (args) => ({
+ template: hbs``,
+ context: args,
+});
+
+
+
+ {HDSTemplate.bind({})}
+
+
+
+# Rose Badge (Deprecated)
+
+Rose/Badge has been deprecated in favor of [HDS::Badge](https://design-system-components-hashicorp.vercel.app/components/badge)
+
+### usage:
A badge component that supports icons and predefined styles.
When style definition isn't supplied, a default style will be supplied.
@@ -28,7 +66,7 @@ export const Template = (args) => ({
({
-
+
{{
template: hbs`
default style