diff --git a/.changeset/spotty-frogs-exercise.md b/.changeset/spotty-frogs-exercise.md new file mode 100644 index 00000000000..ac98342ba1d --- /dev/null +++ b/.changeset/spotty-frogs-exercise.md @@ -0,0 +1,5 @@ +--- +'polaris.shopify.com': minor +--- + +Added New badge pattern guidance for the primary nav diff --git a/polaris.shopify.com/content/components/navigation.md b/polaris.shopify.com/content/components/navigation.md index d5c9e12edc0..1cfed94b13e 100644 --- a/polaris.shopify.com/content/components/navigation.md +++ b/polaris.shopify.com/content/components/navigation.md @@ -62,6 +62,7 @@ The navigation component should: - Use a major icon for item actions. - Use a minor icon for secondary actions. - Use the provided navigation section component to group navigation items. +- Not use the [New badge](/patterns/new-badge) in navigation items. --- diff --git a/polaris.shopify.com/content/patterns/new-badge.md b/polaris.shopify.com/content/patterns/new-badge.md index 661a1c83044..903904a2bfe 100644 --- a/polaris.shopify.com/content/patterns/new-badge.md +++ b/polaris.shopify.com/content/patterns/new-badge.md @@ -24,8 +24,16 @@ The New badge should be used on features that have all of these 3 characteristic - It’s creating new value for merchants (not just an improved way of doing something they are already doing) - It’s worth distracting our merchants from their current workflow to inform them about a whole new part of Shopify +Example: +- To signify an entirely new page in the Settings nav + +Note: Using the New badge in the Settings nav to draw attention to a new feature must be reviewed and approved by UX management on a case by case basis. + Consider how the admin would look if it was cluttered with New badges or features of varying importance—overusing the badge creates unnecessary distraction and lessens its impact. +### When not to use the New badge +- Should never be used in the primary [navigation](/components/navigation) menu of the Shopify admin + ## How long to use the New badge New badges should have a short lifespan. The badge should disappear: