The orientation CSS descriptor controls the orientation of a document defined by @viewport.

/* Keyword values */
orientation: auto;
orientation: portrait;
orientation: landscape;

For a UA/device where the orientation is changed upon tilting the device, an author can use this descriptor to inhibit the orientation change.

Related at-rule@viewport
Initial valueauto
Percentagesrefer to the size of bounding box
Mediaas each of the properties of the shorthand:
Computed valueas specified
Canonical orderthe unique non-ambiguous order defined by the formal grammar

Syntax

Values

auto
The user agent will set the document's orientation automatically, typically based on the device's orientation as determined by an accelerometer (if the device has such a hardware sensor), although there is often a user-controlled, OS-level "Lock orientation" setting that will trump the accelerometer reading.
portrait
The document should be locked into portrait orientation.
landscape
The document should be locked into landscape orientation.

Formal syntax

auto | portrait | landscape

Specifications

Specification Status Comment
CSS Device Adaptation
The definition of '"orientation" descriptor' in that specification.
Working Draft Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic support
Experimental
Chrome No support NoEdge ? Firefox No support NoIE Full support 10
Prefixed
Full support 10
Prefixed
Prefixed Requires the vendor prefix: -ms-
Opera No support NoSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android ? Opera Android Full support 8
Prefixed
Full support 8
Prefixed
Prefixed Requires the vendor prefix: -o-
Safari iOS ? Samsung Internet Android No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

Document Tags and Contributors

Last updated by: connorshea,