Vendor design language

Liquid Glass

Apple controls float like lenses above opaque content.

Also called: Apple Liquid Glass, iOS 26 glass design

Web approximation: glass controls above opaque content.

Understand

Definition and scope

Liquid Glass is Apple’s adaptive material for controls and navigation. It visually lenses underlying content, adapts its tint, and reserves glass for the control layer.

Scope: The name refers to an Apple vendor language and APIs. On the web, any reproduction remains an approximation and must be labeled as such.

Recognize

The four defining signals should remain visible without relying on the style name.

Layout

Glass reserved for controls

Bars, buttons, and navigation float above content that remains opaque.

Depth

Lensing effect

Edges concentrate light and suggest refraction richer than a simple blur.

Color

Adaptive tint

The material adjusts its appearance to the content passing underneath.

Geometry

Concentric capsules

Controls use capsules and nested radii that share an optical center.

Choose

Good context

An Apple app using system navigation and control components.
A control layer that must remain distinct from scrolling content.

Misuse

Presenting a CSS blur and transparency recipe as an official Apple API.
Making content cards transparent instead of limiting glass to controls.

Compare

Decisive difference with the closest neighbor

Liquid Glass vs GlassmorphismGlassmorphism decorates content surfaces. Liquid Glass reserves an adaptive material for Apple controls and navigation.

Understand → Recognize → Choose → Compare

Pack for your agent

Pre-written instruction by SkillCodex — your request is neither sent nor used to adapt this text; no content is generated, and copying executes nothing.

implementation

Implement in your agent

# Implement Liquid Glass in your agent

## Objective
Create this interface with native Liquid Glass APIs on Apple platforms. Reserve the material for floating controls and navigation. Keep content opaque, readable, and structurally independent from the material.

## Prerequisites
- Inspect existing components, tokens, and brand constraints.
- Confirm that this style fits the surface and content.
- Preserve existing structure, semantics, and interactions.

## Behavior and surfaces
- Glass reserved for controls — Bars, buttons, and navigation float above content that remains opaque.
- Lensing effect — Edges concentrate light and suggest refraction richer than a simple blur.
- Adaptive tint — The material adjusts its appearance to the content passing underneath.
- Concentric capsules — Controls use capsules and nested radii that share an optical center.

## States
- Cover existing default, hover, focus, active, disabled, loading, and error states.
- Provide a static state when reduced motion is requested.

## Accessibility
- Test legibility over every kind of content that may scroll under the material.
- Honor Reduce Transparency and Reduce Motion settings.
- Keep focus and selection states that do not depend on refraction alone.

## Non-goals
- Presenting a CSS blur and transparency recipe as an official Apple API.
- Making content cards transparent instead of limiting glass to controls.

## Acceptance criteria
- An Apple app using system navigation and control components.
- A control layer that must remain distinct from scrolling content.

sha256:b6ba2cc7fb475de3774589dac6ee51427365cadd72dd443b92094185b759c8d0

debugging

Debug in your agent

# Debug Liquid Glass in your agent

## Observed symptom
[DÉCRIS ICI LE SYMPTÔME]

## Observable checks
- Compare the surface with the documented visual signals.
- Verify contrast, focus, reduced motion, and fallback behavior.
- Isolate the visual layer without changing functional structure.

## Possible causes
- The style hides hierarchy or reduces contrast.
- The effect is applied to too many surfaces or depends on an unavailable API.
- An interactive state is no longer perceivable.

## Bounded corrections
Repair this implementation by removing glass from content surfaces. On Apple, replace imitations with system APIs. On the web, label it as an approximation and add an opaque fallback.

## Final verification
- Test legibility over every kind of content that may scroll under the material.
- Honor Reduce Transparency and Reduce Motion settings.
- Keep focus and selection states that do not depend on refraction alone.

sha256:523a5932319cc5f6330bc1a5211064e0e766c61afeaac1fcbd0d1c7ecde63689

Pack digest: sha256:b9898fcb3fffeccae266f0a2261bb516105a0813c6326c7f7654d91c81070700

Accessibility and verification

1Test legibility over every kind of content that may scroll under the material.
2Honor Reduce Transparency and Reduce Motion settings.
3Keep focus and selection states that do not depend on refraction alone.

Sources

Editorial revision: 1.2.2
Sources consulted on: 2026-07-20
Source catalog digest: sha256:6e047c91ac34b3558576dea986805be6086c1a5a18ed2ed27fa1e56214cef304; sha256-utf8-canonical-json-lf/v1

Open the versioned source catalog

# Implement Liquid Glass in your agent ## Objective Create this interface with native Liquid Glass APIs on Apple platforms. Reserve the material for floating controls and navigation. Keep content opaque, readable, and structurally independent from the material. ## Prerequisites - Inspect existing components, tokens, and brand constraints. - Confirm that this style fits the surface and content. - Preserve existing structure, semantics, and interactions. ## Behavior and surfaces - Glass reserved for controls — Bars, buttons, and navigation float above content that remains opaque. - Lensing effect — Edges concentrate light and suggest refraction richer than a simple blur. - Adaptive tint — The material adjusts its appearance to the content passing underneath. - Concentric capsules — Controls use capsules and nested radii that share an optical center. ## States - Cover existing default, hover, focus, active, disabled, loading, and error states. - Provide a static state when reduced motion is requested. ## Accessibility - Test legibility over every kind of content that may scroll under the material. - Honor Reduce Transparency and Reduce Motion settings. - Keep focus and selection states that do not depend on refraction alone. ## Non-goals - Presenting a CSS blur and transparency recipe as an official Apple API. - Making content cards transparent instead of limiting glass to controls. ## Acceptance criteria - An Apple app using system navigation and control components. - A control layer that must remain distinct from scrolling content.

# Debug Liquid Glass in your agent ## Observed symptom [DÉCRIS ICI LE SYMPTÔME] ## Observable checks - Compare the surface with the documented visual signals. - Verify contrast, focus, reduced motion, and fallback behavior. - Isolate the visual layer without changing functional structure. ## Possible causes - The style hides hierarchy or reduces contrast. - The effect is applied to too many surfaces or depends on an unavailable API. - An interactive state is no longer perceivable. ## Bounded corrections Repair this implementation by removing glass from content surfaces. On Apple, replace imitations with system APIs. On the web, label it as an approximation and add an opaque fallback. ## Final verification - Test legibility over every kind of content that may scroll under the material. - Honor Reduce Transparency and Reduce Motion settings. - Keep focus and selection states that do not depend on refraction alone.