Badge

Import

import { Badge } from '@contentful/f36-components';
// or
import { Badge } from '@contentful/f36-badge';

Examples

Primary

Used for the entity that has been changed

Open in Playground
function PrimaryBadgeExample() {
  return <Badge variant="primary">changed</Badge>;
}
function PrimaryBadgeExample() {
  return <Badge variant="primary">changed</Badge>;
}
Hide source

Primary filled

Used to highlight a new functionality or to indicate changes in the interface.

Open in Playground
function PrimaryFilledBadgeExample() {
  return <Badge variant="primary-filled">new</Badge>;
}
function PrimaryFilledBadgeExample() {
  return <Badge variant="primary-filled">new</Badge>;
}
Hide source

Positive

Used for the entity that has been published

Open in Playground
function PositiveBadgeExample() {
  return <Badge variant="positive">published</Badge>;
}
function PositiveBadgeExample() {
  return <Badge variant="positive">published</Badge>;
}
Hide source

Negative

Used for the entity that has been deleted.

Open in Playground
function NegativeBadgeExample() {
  return <Badge variant="negative">deleted</Badge>;
}
function NegativeBadgeExample() {
  return <Badge variant="negative">deleted</Badge>;
}
Hide source

Warning

Used for the entity that has been deleted.

Open in Playground
function WarningBadgeExample() {
  return <Badge variant="warning">draft</Badge>;
}
function WarningBadgeExample() {
  return <Badge variant="warning">draft</Badge>;
}
Hide source

Secondary

Used for all the secondary elements, for example in the list of versions:

Open in Playground
function SecondaryBadgeExample() {
  return <Badge variant="secondary">current</Badge>;
}
function SecondaryBadgeExample() {
  return <Badge variant="secondary">current</Badge>;
}
Hide source

Featured

Used for featured entities that should be highlighted.

Open in Playground
function FeaturedBadgeExample() {
  return <Badge variant="featured">trial</Badge>;
}
function FeaturedBadgeExample() {
  return <Badge variant="featured">trial</Badge>;
}
Hide source

Badge sizes

Default

Open in Playground
function DefaultSizeExample() {
  return <Badge variant="positive">published</Badge>;
}
function DefaultSizeExample() {
  return <Badge variant="positive">published</Badge>;
}
Hide source

Small

Open in Playground
function SmallSizeExample() {
  return (
    <Badge variant="primary-filled" size="small">
      new
    </Badge>
  );
}
function SmallSizeExample() {
  return (
    <Badge variant="primary-filled" size="small">
      new
    </Badge>
  );
}
Hide source

Badge also accepts all HTML attributes (as React properties) that are applicable to the usual div tag.

Content guidelines

• badges are used to inform users of the status of an element in the interface
• keep in mind the recommended color coding for each of variant
• try to use labels with short, scannable text
• try to use a single word to describe the status of an element
• try to describe the status in the past tense, like changed or archived

Accessibility

• text must be clear enough for color-blind users to be able to understand immediately without needing to rely only on the color.