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

function PrimaryBadgeExample() {
  return <Badge variant="primary">Changed</Badge>;
}

Primary filled

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

function PrimaryFilledBadgeExample() {
  return <Badge variant="primary-filled">New</Badge>;
}

Positive

Used for the entity that has been published

function PositiveBadgeExample() {
  return <Badge variant="positive">Published</Badge>;
}

Negative

Used for the entity that has been deleted.

function NegativeBadgeExample() {
  return <Badge variant="negative">Deleted</Badge>;
}

Warning

Used for the entity that has been deleted.

function WarningBadgeExample() {
  return <Badge variant="warning">Draft</Badge>;
}

Secondary

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

function SecondaryBadgeExample() {
  return <Badge variant="secondary">Current</Badge>;
}

Featured

Used for featured entities that should be highlighted.

function FeaturedBadgeExample() {
  return <Badge variant="featured">Trial</Badge>;
}

Badge sizes

Default

function DefaultSizeExample() {
  return <Badge variant="positive">Published</Badge>;
}

Small

function SmallSizeExample() {
  return (
    <Badge variant="primary-filled" size="small">
      New
    </Badge>
  );
}

Icons

You can add an icon by providing the following props:

• startIcon – adds icon to the left side of the badge
• endIcon – adds icon to the right side of the badge

function StartIconExample() {
  return (
    <Stack>
      <Badge startIcon={<EnvironmentAliasIcon />}>Main</Badge>
      <Badge endIcon={<ClockIcon />}>Scheduled</Badge>
    </Stack>
  );
}

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.