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. + +