WebKit Previews Spatial CSS in visionOS 27.3: What Web Designers Can Explore
WebKit has introduced a developer preview of spatial CSS for Safari on visionOS 27.3, experimenting with a more declarative way to arrange 3D objects on the web. Instead of requiring every scene composition decision to be managed by JavaScript, the proposal brings familiar CSS concepts, including transforms, anchoring and environment-aware presentation, into a spatial setting.
This is not a new CSS feature that all browsers can use today. WebKit describes it as a limited preview of a proposed API, available through an experimental feature flag on Vision Pro or in the visionOS Simulator. That distinction matters for developers considering whether to use it on customer-facing websites. The November 16 announcement and its demonstrations are available in the official WebKit post.
What the preview actually includes
The first set of capabilities is centered on grouping and arranging 3D models:
spatial: portalgroups models in a shared spatial scene.- CSS
transformcan move models within that portal. position-anchor, together withposition-context: anchor, can attach models to reference points defined in another model.@environment-mapis proposed for managing lighting environments.portal-action: orbitlets viewers rotate a scene.requestVolumetricScene()can launch connected content outside the browser window on supported hardware after a user action.
WebKit’s demonstration uses a shape-sorting puzzle with a board and movable blocks. The example shows how 3D composition could work more like a responsive interface: models can be positioned, animated and adapted with declarative rules instead of being entirely controlled by a custom scene engine.
The team also points to familiar web-design concerns such as aspect ratio, color themes and reduced-motion preferences. Those requirements do not disappear when content becomes spatial.
Why this could matter beyond headsets
Many ecommerce sites, educational tools and product documentation pages already use 3D models on ordinary screens. A standards-based method for composition could eventually help the same content adapt across phones, laptops and spatial displays. WebKit’s existing <model> element in Safari 27 provides part of that foundation, but the new spatial CSS behaviors are experimental and much more narrowly available.
For now, a practical strategy is progressive enhancement. Deliver an accessible image, text explanation or conventional model viewer first. Introduce experimental 3D arrangement only when the relevant environment supports it. Never hide essential product specifications or controls inside an experience that requires a headset or experimental flag.
The accessible color system guide covers focus states, contrast and visual meaning for the surrounding interface. For fallback screenshots and product imagery, the responsive images guide is a useful companion.
How developers can test the preview
According to WebKit, enable Settings > Apps > Safari > Advanced > Feature flags > CSS Portals on Vision Pro with visionOS 27.3 or in the visionOS Simulator. The official article links to a working demonstration and instructions for installing additional simulator runtimes through Xcode.
A focused test should answer more than “does the 3D model appear?” Check whether the interface retains a useful 2D fallback, whether controls are discoverable, and whether motion settings and labels remain appropriate. Record which environment and feature flags were required so a future teammate does not mistake a preview-only effect for broadly deployed browser support.
What happens next
WebKit is actively inviting developer feedback on the proposed specification. The feature names and behavior may change as standardization progresses, and its November 16 post should not be read as a universal browser compatibility announcement.
The same distinction between a feature preview and ordinary browser support applies to the earlier Safari foldable-screen APIs: start with a working interface, then test the optional enhancement in its documented environment.