Last Updated: Dec 10, 2025
Ink's elevation scale defines the depth and layering of surfaces—from flat backgrounds to highly elevated, interactive elements. Use these values to create visual hierarchy, focus, and separation between components.
| Value | Name | Usage | Example |
|---|---|---|---|
| flat | Indicates zero elevation. no shadow is applied. Used for static or foundational surfaces. | Flat tiles, background-level surfaces | |
| small | Subtle shadow that lifts components slightly above the base layer. | Lightweight UI like tooltips or small floating elements | |
| medium | Creates moderate separation from the background. Ideal for core interactive surfaces. | Cards, floating tiles, secondary surfaces | |
| large | Strongest elevation. Emphasizes prominence and pulls the element to the forefront. | Modals, top-level UI, attention-heavy elements |
Do
Don't
Visibility & Focus
Depth & Comprehension
Q. Does elevation change between light and dark mode?
A. No. Elevation tokens remain constant; shadow rendering adapts automatically per theme.
Q. What's the difference between elevation levels?
A. Placeholder: Each level represents increasing visual prominence and separation from the base surface.
Q. Can elevation be combined with borders?
A. Yes. Borders can reinforce separation when shadows alone are insufficient.
Q. Should elevation replace focus indicators?
A. Never. Focus must always be signaled by a visible outline.
Usage
Examples
Best Practices
Accessibility
Q&A