Spacing and layout
A shared spacing scale, grid and set of breakpoints, so every page lines up the same way on mobile, tablet and desktop.
Updated
Spacing scale
Fourteen steps for padding and gaps inside components. They stay the same on every device. Most layouts only need 8, 16, 24 and 32.
| Token | Value | Size | Use |
|---|---|---|---|
| spacing/0 | 0px | Flush edges and resets. | |
| spacing/025 | 2px | Optical nudges only. | |
| spacing/050 | 4px | Tight gaps, such as icon to label. | |
| spacing/075 | 6px | Optical padding only. | |
| spacing/100 | 8px | Small gaps between related items. | |
| spacing/150 | 12px | Control padding and list row gaps. | |
| spacing/200 | 16px | Default component padding and gap. | |
| spacing/250 | 20px | Comfortable control padding. | |
| spacing/300 | 24px | Card internals and stacked fields. | |
| spacing/400 | 32px | Gaps between groups inside a component. | |
| spacing/500 | 40px | Large separations inside a component. | |
| spacing/600 | 48px | Feature blocks within a section. | |
| spacing/800 | 64px | Large feature spacing. | |
| spacing/1000 | 80px | Hero and campaign separation. |
Layout spacing
Bigger spaces between parts of a page. These change with the screen size, so pages breathe more on desktop.
| Token | Mobile | Tablet | Desktop | Use |
|---|---|---|---|---|
| layout/section-gap | 48px | 64px | 96px | Between page sections. |
| layout/block-gap | 24px | 32px | 48px | Between groups inside a section. |
| layout/card-padding | 16px | 24px | 24px | Inside cards, panels and modals. |
| layout/nav-height | 56px | 64px | 72px | Height of the top navigation bar. |
Grid
A 4, 8 and 12 column grid. Content never goes wider than 1,200px and centres on wider screens.
-
Mobile
4 columns · 16px gutter · 16px margin
-
Tablet
8 columns · 24px gutter · 32px margin
-
Desktop
12 columns · 24px gutter · 64px margin
| Token | Mobile | Tablet | Desktop |
|---|---|---|---|
| grid/columns | 4 | 8 | 12 |
| grid/gutter | 16px | 24px | 24px |
| grid/margin | 16px | 32px | 64px |
| grid/container-max | 1200px | 1200px | 1200px |
| grid/column-width | 73.75px | 67px | 78px |
Column width is measured at the reference widths (375, 768 and 1440px). Columns stretch between them.
Breakpoints
Three screen sizes. Design at the reference width for each, and check the edges of every range.
| Screen | Range | Reference size | Typical devices |
|---|---|---|---|
| Mobile | 0–767px | 375 × 812 | Low-cost Android phones. Design here first. |
| Tablet | 768–1279px | 768 × 1024 | Tablets and small laptops. |
| Desktop | 1280px and up | 1440 × 1024 | Laptops and desktops. |
Corner radius
Four steps. The docs use 4px for cards, tables and tiles, and 2px for panels inside them.
-
radius/025
2px
Panels inside a card. Hairline rounding.
-
radius/050
4px
Cards, tables, tiles and tags.
-
radius/100
8px
Controls and media, per the token description.
-
radius/200
16px
Large containers, per the token description.
Border width
Two widths. Use thin for nearly everything.
-
border/width/thin
1px
Default stroke for borders and dividers.
-
border/width/thick
2px
Emphasis strokes.
Icon sizes
Pick the icon size from the text next to it. Tap targets come from padding in the component, not from the icon.
-
size/icon/sm
16px
Next to 14px text: tags, badges and table cells.
-
size/icon/md
20px
Next to 16px text. The default.
Accessibility
Space and layout decide whether people can tap, zoom and read without losing their place.
- Pages reflow to a single column at 320px wide, with no sideways scrolling (WCAG 1.4.10).
- Tap targets are at least 24 × 24px, and 44 × 44px for main actions on mobile like menu and close (WCAG 2.5.8).
- Spacing between targets is at least 8px (spacing/100), so people don’t press the wrong thing.
- Layouts still work when text is zoomed to 200%. Containers grow; nothing is clipped.
- Reading order in code matches the visual order on every screen size.
Using the tokens
The same names work in Figma, code and WordPress.
- In Figma
Bind padding, gaps, radius and stroke to the Static and Device variables. Use the Grids page layout grids.
- In code
Use the CSS variables with the same names, and the breakpoint values for media queries. Exact names to be confirmed with the developers.
- In WordPress
The theme sets the grid and spacing. Use block spacing presets, not custom pixel values.
- New values
Don’t invent spacing in a project. If nothing fits, ask the NDS team.
References
- WCAG 2.2: Reflow, 1.4.10 w3.org
- WCAG 2.2: Target size (minimum), 2.5.8 w3.org
- GOV.UK Design System: Layout design-system.service.gov.uk
Feedback
Is this page useful?