Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Latest release: Component Library: v56.10.0 released on Aug 3, 2026 | Guidance: Sprint 4 released on Aug 4, 2026 | Figma: Changelog

Foundation

Spacing

Spacing scale and semantic spacing tokens.

Generated from css-library v0.34.1 (Tue, 04 Aug 2026 20:19:43 GMT).

For guidance on the spacing scale and how to apply it, see the spacing units page.

Semantic spacing tokens

Token Value Notes vads-spacing-inset-s 16px
vads-spacing-2 Small spacing within an item (internal padding). vads-spacing-vertical-stack-default 16px
vads-spacing-vertical-stack-s Default spacing between vertically stacked items. vads-spacing-vertical-stack-s 16px
vads-spacing-2 Small spacing between items in a stack. vads-spacing-inset-m 24px
vads-spacing-3 Medium spacing within an item (internal padding). vads-spacing-vertical-stack-m 24px
vads-spacing-3 Medium spacing between items in a stack. vads-forms-spacing-vertical-stack-default 32px
vads-spacing-vertical-stack-l Default spacing between form fields. For non-form stacks, use vads-spacing-vertical-stack-default. vads-spacing-inset-l 32px
vads-spacing-4 Large spacing within an item (internal padding). vads-spacing-vertical-stack-l 32px
vads-spacing-4 Large spacing between items in a stack.

Primitive spacing tokens

Token Value Notes vads-spacing-neg-15 -120px units-neg-15 namespaced for VADS. vads-spacing-neg-10 -80px units-neg-10 namespaced for VADS. vads-spacing-neg-9 -72px units-neg-9 namespaced for VADS. vads-spacing-neg-8 -64px units-neg-8 namespaced for VADS. vads-spacing-neg-7 -56px units-neg-7 namespaced for VADS. vads-spacing-neg-6 -48px units-neg-6 namespaced for VADS. vads-spacing-neg-5 -40px units-neg-5 namespaced for VADS. vads-spacing-neg-4 -32px units-neg-4 namespaced for VADS. vads-spacing-neg-3 -24px units-neg-3 namespaced for VADS. vads-spacing-neg-2p5 -20px units-neg-2p5 namespaced for VADS. vads-spacing-neg-2 -16px units-neg-2 namespaced for VADS. vads-spacing-neg-1p5 -12px units-neg-1p5 namespaced for VADS. vads-spacing-neg-1 -8px units-neg-1 namespaced for VADS. vads-spacing-neg-0p5 -4px units-neg-0p5 namespaced for VADS. vads-spacing-neg-2px -2px units-neg-0p25 namespaced for VADS. vads-spacing-neg-1px -1px units-neg-1px namespaced for VADS. vads-spacing-0 0
uswds-system-spacing-special-0 units-0 namespaced for VADS. vads-spacing-1px 1px
uswds-system-spacing-1px units-1px namespaced for VADS. vads-spacing-2px 2px
uswds-system-spacing-2px units-0p25 namespaced for VADS. vads-spacing-0p5 4px
uswds-system-spacing-05 units-0p5 namespaced for VADS. vads-spacing-1 8px
uswds-system-spacing-1 units-1 namespaced for VADS. vads-spacing-1p5 12px
uswds-system-spacing-105 units-1p5 namespaced for VADS. vads-spacing-2 16px
uswds-system-spacing-2 units-2 namespaced for VADS. vads-spacing-2p5 20px
uswds-system-spacing-205 units-2p5 namespaced for VADS. vads-spacing-3 24px
uswds-system-spacing-3 units-3 namespaced for VADS. vads-spacing-4 32px
uswds-system-spacing-4 units-4 namespaced for VADS. vads-spacing-5 40px
uswds-system-spacing-5 units-5 namespaced for VADS. vads-spacing-6 48px
uswds-system-spacing-6 units-6 namespaced for VADS. vads-spacing-7 56px
uswds-system-spacing-7 units-7 namespaced for VADS. vads-spacing-8 64px
uswds-system-spacing-8 units-8 namespaced for VADS. vads-spacing-9 72px
uswds-system-spacing-9 units-9 namespaced for VADS. vads-spacing-10 80px
uswds-system-spacing-10 units-10 namespaced for VADS. vads-spacing-15 120px
uswds-system-spacing-15 units-15 namespaced for VADS.

Units (inherited from USWDS)

These units-* tokens are inherited from USWDS.

Token Value Notes units-neg-15 -7.5rem (-120px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-10 -5rem (-80px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-9 -4.5rem (-72px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-8 -4rem (-64px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-7 -3.5rem (-56px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-6 -3rem (-48px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-5 -2.5rem (-40px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-4 -2rem (-32px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-3 -1.5rem (-24px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-2p5 -1.25rem (-20px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-2 -1rem (-16px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-1p5 -0.75rem (-12px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-1 -0.5rem (-8px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-0p5 -0.25rem (-4px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-0p25 -2px Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-neg-1px -1px Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-0 0 Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-1px 1px Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-0p25 2px Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-0p5 0.25rem (4px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-1 0.5rem (8px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-1p5 0.75rem (12px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-2 1rem (16px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-2p5 1.25rem (20px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-3 1.5rem (24px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-4 2rem (32px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-5 2.5rem (40px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-6 3rem (48px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-7 3.5rem (56px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-8 4rem (64px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-9 4.5rem (72px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-10 5rem (80px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work. units-15 7.5rem (120px) Inherited from USWDS. Prefer the vads-spacing-* equivalent in new work.
Edit this page in GitHub (Permissions required)
Last updated: Jul 06, 2026