From 90e5443abb36b632c4e4f6a6e8ce6425ca98618a Mon Sep 17 00:00:00 2001
From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com>
Date: Thu, 6 Nov 2025 15:52:58 -0500
Subject: [PATCH] docs(label): Add guidelines for preview labels.
---
.../components/label/img/preview-labels.svg | 47 +++++++++++++++++++
.../content/components/label/label.md | 14 ++++++
2 files changed, 61 insertions(+)
create mode 100644 packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg
diff --git a/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg b/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg
new file mode 100644
index 0000000000..633dee8afd
--- /dev/null
+++ b/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg
@@ -0,0 +1,47 @@
+
diff --git a/packages/documentation-site/patternfly-docs/content/components/label/label.md b/packages/documentation-site/patternfly-docs/content/components/label/label.md
index bb6805d5cb..6ed6ef1823 100644
--- a/packages/documentation-site/patternfly-docs/content/components/label/label.md
+++ b/packages/documentation-site/patternfly-docs/content/components/label/label.md
@@ -63,6 +63,20 @@ Labels are typically used in filter and selection use cases to indicate what sel
+#### Preview labels
+
+To communicate that a feature is in a preview mode, instead of fully released and supported, use a [nonstatus purple label](#nonstatus-labels). There are 2 common types of preview labels:
+1. **Developer preview:** Intended for early evaluation and feedback. These features are not supported and not ready for production environments.
+2. **Technology preview:** Available for early use and feedback. These features have limited support and are typically on the roadmap for a future full release.
+
+Preview labels should use the compact size variant and should be placed beside the title of the new feature or component—ideally to the right of the feature title.
+
+Preview labels should also be clickable. When clicked, display a popover with a brief explanation of the preview type (stability, potential limitations) and include a "Learn more" link directing users to dedicated documentation.
+
+
+
+
+
#### Color considerations
Labels can utilize both our [status](/foundations-and-styles/colors#status-and-state-colors) and [nonstatus](/foundations-and-styles/colors#nonstatus-colors) color palettes.