Divider Open in Figma
The Separator (aka Divider) component is a visual element that creates separation between different content sections, groups, or interface elements. Also commonly referred to as a separator, rule, or line divider, this component serves as a subtle yet effective option to organize hierarchy and improve scanability.
pivot-divider is a simple horizontal rule component for visually separating content sections. It renders a semantic <hr> element with customizable spacing and color variations.
Quick Start
<!-- Default divider with 40px margin -->
<pivot-divider></pivot-divider>
<!-- Divider with reduced spacing (20px margin) -->
<pivot-divider pivot-margin="20"></pivot-divider>
<!-- Divider with no margin -->
<pivot-divider pivot-margin="0"></pivot-divider>
<!-- Inverse color divider, for use on dark backgrounds -->
<pivot-divider pivot-version="inverse"></pivot-divider>pivot-margin and pivot-version can be combined freely, e.g. <pivot-divider pivot-margin="20" pivot-version="inverse"></pivot-divider>.
Styling Best Practices
- Use semantic spacing: Choose a
pivot-marginvalue that matches the visual weight of the sections it separates. - Match background: Use
pivot-version="inverse"on dark backgrounds and the default version on light backgrounds — the two variants set differentbackground-colorvalues on the rendered<hr>and are not interchangeable. - Keep it simple: The divider is intentionally minimal; avoid adding additional styling or content to it.
Accessibility
pivot-divider renders a bare <hr /> with no other markup. The <hr> element carries an implicit ARIA role of separator, so no explicit role or other ARIA attributes are needed for assistive technology to recognize it as a thematic break (WCAG 4.1.2).
Screen Reader Behavior
Screen readers announce the element as a horizontal rule or separator when encountered, signaling a thematic break between the surrounding content. No accessible name or description is associated with it.
Keyboard Navigation
pivot-divider is not interactive. It receives no keyboard handlers and responds to no keys.
Focus Management
The component does not participate in the tab order and never receives or manages focus — the native <hr> element is not focusable and pivot-divider adds no tabindex or focus behavior of its own.
References
API Reference
Props
| Name | Type | Default | Description |
|---|---|---|---|
pivot-margin |
0 | 20 | 40 |
40 |
The margin spacing around the divider in pixels. |
pivot-version |
"default" | "inverse" |
"default" |
The color of the divider. |
CSS Custom Properties
| Name | Description |
|---|---|
--component-divider-default |
Background color of the divider in the default color variant. |
--component-divider-inverse |
Background color of the divider in the inverse color variant. |
Divider
The Separator (aka Divider) component is a visual element that creates separation between different content sections, groups, or interface elements. Also commonly referred to as a separator, rule, or line divider, this component serves as a subtle yet effective option to organize hierarchy and improve scanability.
Usage
Primary use cases
Separators are primarily used to formally divide 2 pieces of information that both apply to the section or header that they are under but which do not completely apply to each other.
When to use
- Content within a section needs clear visual separation
- When needing to divide 2 distinct pieces of information without the use of sections.
- When a section is revealed through the use of a button or link (for example, a show/hide link revealing a new and temporary piece of information)
When not to use
- Between lines on a list
- Between strongly styled containers (like cards sections or blocks) already exist
Do’s and Don’ts
Follow these guidelines to ensure consistent, accessible, and user-friendly implementation of this [component/pattern/foundation].

✅ Do
or do not

⚠️ Caution
Avoid adding a divider in a page that already has multiple horizontal rules. for example, on pages with lots of accordions which already have their own version of a separator.
❌ Don’t
Don’t stack multiple dividers close together. If many pieces of small information need to be broken up consider using a different pattern such as blocks.
❌ Don’t
Don’t use as decorations above or below content.
AEM Authoring Guidance
Search all the previous QA items sent to marketing team regarding this component and paste them here. This section might just be text [later we can add screenshots]
To implement this component:
- Instructions
- Instructions
- Instructions
Variants (styles in AEM - for authors)
This component includes the following variants for authors in AEM
Margin
- False (no padding)
- True (use divider-padding)
Alignment Options
- Option 1
- Option 2
Size Options
- Option 1
- Option 2
Design Considerations
- Consideration 1
- Consideration 2
- Consideration 3
Notes
- Quick note 1
- Quick note 2
- Quick note 3
Design Tokens Used
Variables Name
Pivot Tokens/
component/separator/divider-inverse
(#E5E5E5)
Pivot Tokens/
component/separator/divider-default
(#CCCCCC)
Pivot Breakpoints/
space/space-dividerPadding
Pivot Tokens/
component/separator/separatorMargin0
Status & Change-Log
The following section provides a snapshot of the component’s current status and a history of key updates over time.
[check our pivot file for decisions documented there and check our decision log page. Add them chronologically, latest one on top]
Status
Is there any relevant information to know about the current status of this component. For example:
- Are we currently conducting A/B testing to learn something about this component
- Are we currently refactoring this component in AEM and the name will change
- Are we currently deprecating any parts or variants in this component
Change-Log
The information below captures key milestones in the design, revision, and implementation of this component. Use this as a reference for understanding how, when, and why major changes were made.
2025.08.26 - initial rework
Deciding Members:
Michael
Decision:
- renamed from “divider” to “separator”
- removed “dark” variation
- renamed “light” to “inverse”
- added 0/20/40px margin options with 40 being the default
- created an unused prop for “full width” but have not set up an “inset” version for now.
Reasoning:
initial setup was not in line with AEM’s methods or madness or the team’s needs.
Default version (pivot-margin)
<pivot-divider pivot-version="default" pivot-margin="0"></pivot-divider>
<pivot-divider pivot-version="default" pivot-margin="20"></pivot-divider>
<pivot-divider pivot-version="default" pivot-margin="40"></pivot-divider>Inverse version (pivot-margin)
<pivot-divider pivot-version="inverse" pivot-margin="0"></pivot-divider>
<pivot-divider pivot-version="inverse" pivot-margin="20"></pivot-divider>
<pivot-divider pivot-version="inverse" pivot-margin="40"></pivot-divider>