Divider

A divider is a thin line that groups content in lists and layouts.

DesignUsageAccessibilityUpdates

Purpose

Create visual breathing room

Dividers introduce a pause between content sections, helping users mentally separate one topic from the next.

Group without boxing

A line is lighter than a card border — use dividers when you want to separate content without enclosing it.

Works horizontally and vertically

Orientation options let dividers separate both stacked sections and side-by-side elements consistently across layouts.

Anatomy

Left Right
1

Rule

2

Orientation

Configuration

Orientation

Dividers can run horizontally or vertically depending on the layout direction of the content they separate.

Use to separate content stacked vertically — such as between sections, list rows, or form groups.

Playground

BETA
Orientation

Structure

Left Right

Component tokens

Component tokens are specific to each component. Use the table title as the prefix: border-color-muted under sgds/divider means sgds/divider/border-color-muted.

sgds/divider
CategoryComponent tokenSemantic tokenValueBorderborder-color-mutedsgds/border-color-muted#DFDFDFborder-width-1sgds/border-width/11pxborder-width-2sgds/border-width/2border-width-4sgds/border-width/4

Usage

When to use

  • Use divider to separate related sections when spacing alone does not make the relationship clear enough.
  • Use it sparingly so it supports hierarchy instead of dominating it.

When not to use

  • Do not add dividers between every small block of content.
  • Do not use divider as the only signal that content has changed in meaning or priority.

Best practices

Use the divider to support reading

A divider should quietly separate content without becoming the main thing users notice.

Do not divide everything

Too many dividers add noise and make the page feel heavier than it needs to.

Accessibility considerations

Built-in accessibility

  • Dividers separate sections visually.
  • The component does not add custom keyboard behaviour.

Labels and content

  • Use dividers to separate related groups, not as decoration between every item.
  • Do not rely on a divider as the only cue that the page structure changed.

Focus and interaction

  • Dividers should not receive focus.
  • Use headings or labels to describe the sections on each side of a divider.

Keyboard interaction

This component does not have a separate keyboard interaction table because:

  • Dividers are visual separators and should not receive focus.
  • Use headings or labels to communicate the structure that the divider separates.

Updates

DateVersionDescriptionLoading updates…

Roadmap

Planned itemStatusTargetFuture enhancements for dividerPlannedTBD

Feedback

Have suggestions or feedback?

Share them with us on Slack → #design-system-feedback

Bug Reports

Found a bug or issue?

Report it on GitHub Issues → sgds/components/divider

Singapore Government Design System

The Singapore Government Design System was developed to empower teams in creating fast, accessible and mobile-friendly digital services.