Design Core A2 · Formal specification Platform: Web

CSS Border Radius

CSS border-radius makes box corners from quarter ellipses using horizontal and vertical radii. It changes painting and clipping, but not the box's layout size, and it does not make a mathematical squircle.

See how it works
You might call it border-radiusrounded corner

See how it works

Original worked exampleCSS Border Radius

Another example

A 40 px control uses a 12 px radius and is checked at 200% zoom. It keeps its target size, visible focus outline, correct clipping, shadows, and the same design token in every state. A 9999 px radius makes a pill, not a squircle.

Main parts

  1. 01horizontal radius
  2. 02vertical radius
  3. 03painting and clipping edge

Use it when

Use this term for CSS ellipse corners with clear radii while testing clipping, focus, shadows, and target size.

Do not use it when

Do not use border radius as a vague style word. Do not call every large radius a squircle. Clipping must not shrink the usable target.

Name used in code

border-radius: horizontal / vertical radii

Before you ship

Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience.

Request you can copy

Outcome: Use or define CSS Border Radius to make the visual experience clear and easy to use. User context: A 40 px control uses a 12 px radius and is checked at 200% zoom. It keeps its target size, visible focus outline, correct clipping, shadows, and the same design token in every state. A 9999 px radius makes a pill, not a squircle. Design concept to apply: CSS Border Radius. Why it fits: Use this term for CSS ellipse corners with clear radii while testing clipping, focus, shadows, and target size. Do not use it when: Do not use border radius as a vague style word. Do not call every large radius a squircle. Clipping must not shrink the usable target. Design requirements: Set the content order, shared design values, and reusable components. Define how the layout changes by screen size and state. Keep useful design choices separate from decoration. Inclusion and resilience: Check contrast, zoom, languages, themes, and reduced motion when needed. Do not use color or effects as the only way to show meaning. Acceptance criteria: The design stays clear on phones and desktops, at zoom, in every theme, and in all supported languages. Interactive states stay clear and consistent. Evidence and limits (evidence boundary): A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support. Unknowns to confirm: Brand limits, amount of content, supported themes and languages, target devices, and design-system rules.

Check this request

Review the current use of CSS Border Radius. Definition: CSS border-radius makes box corners from quarter ellipses using horizontal and vertical radii. It changes painting and clipping, but not the box's layout size, and it does not make a mathematical squircle. Release checks: Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.

A2
How official is this term?

Formal specification

A published, versioned formal specification defines this term for the listed technical scope.

A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support.

Scope
CSS rounded corners and border-radius properties
Document status
draft
Checked on
2026-07-30

Evidence sources & scope

Authority source + Term reference · W3C CSS Working Group · draft CSS Backgrounds and Borders Module Level 3 — 4.1 Curve Radii: the border-radius properties 4.1 Curve Radii: the border-radius properties Scope: CSS rounded corners and border radius; direct scope: 4.1 Curve Radii: the border-radius properties Role here: Direct term reference Source covers: canonical name, definition, semantics, implementation Authority source · W3C CSS Working Group · draft CSS Backgrounds and Borders Module Level 3 Scope: CSS rounded corners and border radius Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation

Copy it yourself

The browser could not copy this. Select the request below and copy it yourself.