Divider

Divider is a light gray 1px horizontal or vertical line which groups and divides content in lists and layouts.

Usage guidelines

Dividers should be used to bring clarity and structure to a layout. Primarily, Dividers help to separate groups of related elements or break up dense content.

Don't

Dividers shouldn't be used if elements can be separated using white space.

Best practices

Use whitespace primarily to separate groups of related content.

Don't

Overuse Dividers as this can cause them to lose their value and create unnecessary noise.

Use the default Gestalt Divider - 1px gray line.

Don't

Create your own divider with a different color or stroke style.

Use horizontal Dividers from edge to edge.

Don't

Inset Divider in a way that causes it to be free-floating or separated from content.

Use Dividers to separate collections of content or create the appearance of containers.

Don't

Use Dividers for decoration or to separate grouped content.

Accessibility

Divider is not focusable and is treated as decorative. Screen readers on tab navigation don't announce Dividers but do announce them on left/right quick navigation.

Localization

If you are aligning Divider to content, ensure that it switches sides according to the content's start-end alignment.

Variants

Orientation

You can use this component as a vertical divider between two elements. Placing it within a Flex layout with a direction of row will shift Divider to a vertical orientation.

function Example() {
  const Block = ({ title, text }) => (
    <Flex direction="column" gap={2}>
      <Heading accessibilityLevel="none" size="sm">{title}</Heading>
      <Text size="md">{text}</Text>
    </Flex>
  );

  return (
    <Flex direction="column" gap={10}>
      <Block title="Discover ideas" text="Use the search bar to discover ideas, people and trends. Explore suggested topics or search for topics of your own." />
      <Divider />
      <Block title="Create Pins" text="Upload an image from your computer or mobile device to create a Pin. You can also create Pins from images you find online." />
    </Flex>
  );
}

function Example() {
  const Block = ({ title, text }) => (
    <Flex direction="column" gap={2}>
      <Heading accessibilityLevel="none" size="sm">{title}</Heading>
      <Text size="md">{text}</Text>
    </Flex>
  );

  return (
    <Flex direction="column" gap={10}>
      <Block title="Discover ideas" text="Use the search bar to discover ideas, people and trends. Explore suggested topics or search for topics of your own." />
      <Divider />
      <Block title="Create Pins" text="Upload an image from your computer or mobile device to create a Pin. You can also create Pins from images you find online." />
    </Flex>
  );
}

Horizontal

function Example() {
  const Block = ({ title, text }) => (
    <Flex direction="column" gap={2}>
      <Heading accessibilityLevel="none" size="sm">{title}</Heading>
      <Text size="md">{text}</Text>
    </Flex>
  );

  return (
    <Flex>
      <Box paddingX={4}>
        <Block title="Discover ideas" text="Use the search bar to discover ideas, people and trends. Explore suggested topics or search for topics of your own." />
      </Box>
      <Divider />
      <Box paddingX={4}>
        <Block title="Create Pins" text="Upload an image from your computer or mobile device to create a Pin. You can also create Pins from images you find online." />
      </Box>
    </Flex>
  );
}

function Example() {
  const Block = ({ title, text }) => (
    <Flex direction="column" gap={2}>
      <Heading accessibilityLevel="none" size="sm">{title}</Heading>
      <Text size="md">{text}</Text>
    </Flex>
  );

  return (
    <Flex>
      <Box paddingX={4}>
        <Block title="Discover ideas" text="Use the search bar to discover ideas, people and trends. Explore suggested topics or search for topics of your own." />
      </Box>
      <Divider />
      <Box paddingX={4}>
        <Block title="Create Pins" text="Upload an image from your computer or mobile device to create a Pin. You can also create Pins from images you find online." />
      </Box>
    </Flex>
  );
}

Vertical

Edit page on GitHub