{"abstract":[{"text":"The layout guide representing the portion of your view that is unobscured by bars and other content.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.uikit\/documentation\/UIKit","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaLayoutGuide"},"kind":"symbol","legalNotices":{"copyright":"Copyright © 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["de-DE","en-US","es-419","fr-FR","it-IT","ja-JP","ko-KR","pt-BR","zh-CN"],"extendedModule":"UIKit","externalID":"c:objc(cs)UIView(py)safeAreaLayoutGuide","fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaLayoutGuide"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)UILayoutGuide","text":"UILayoutGuide"}],"modules":[{"name":"UIKit"}],"navigatorTitle":[{"kind":"identifier","text":"safeAreaLayoutGuide"}],"platforms":[{"introducedAt":"11.0","name":"iOS"},{"introducedAt":"11.0","name":"iPadOS"},{"introducedAt":"13.1","name":"Mac Catalyst"},{"introducedAt":"11.0","name":"tvOS"},{"introducedAt":"1.0","name":"visionOS"}],"role":"symbol","roleHeading":"Instance Property","symbolKind":"property","title":"safeAreaLayoutGuide"},"primaryContentSections":[{"declarations":[{"languages":["swift"],"platforms":["iOS","iPadOS","Mac Catalyst","tvOS","visionOS"],"tokens":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaLayoutGuide"},{"kind":"text","text":": "},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UILayoutGuide","kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)UILayoutGuide","text":"UILayoutGuide"},{"kind":"text","text":" { "},{"kind":"keyword","text":"get"},{"kind":"text","text":" }"}]}],"kind":"declarations"},{"kind":"mentions","mentions":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area"]},{"content":[{"anchor":"Discussion","level":2,"text":"Discussion","type":"heading"},{"inlineContent":[{"text":"When the view is visible onscreen, this guide reflects the portion of the view that is not covered by navigation bars, tab bars, toolbars, and other ancestor views. (In tvOS, the safe area reflects the area not covered the screen’s bezel.) If the view is not currently installed in a view hierarchy, or is not yet visible onscreen, the layout guide edges are equal to the edges of the view.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"For the view controller’s root view, the layout guide accommodates the status bar, other visible bars, and any additional insets that you specified using the ","type":"text"},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/additionalSafeAreaInsets","isActive":true,"type":"reference"},{"text":" property of your view controller. For other views in the view hierarchy, the layout guide reflects only the portion of the view that is covered by other content. For example, if a view is entirely within the safe area of its superview, the layout guide edges are equal to the edges of the view.","type":"text"}],"type":"paragraph"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Getting-the-safe-area","generated":true,"identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsets","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsetsDidChange()","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/insetsLayoutMarginsFromSafeArea"],"title":"Getting the safe area"}],"variants":[{"paths":["\/documentation\/uikit\/uiview\/safearealayoutguide"],"traits":[{"interfaceLanguage":"swift"}]},{"paths":["\/documentation\/uikit\/uiview\/safearealayoutguide"],"traits":[{"interfaceLanguage":"occ"}]}],"references":{"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"},"doc://com.apple.uikit/documentation/UIKit":{"abstract":[{"text":"Construct and manage a graphical, event-driven user interface for your iOS, iPadOS, or tvOS app.","type":"text"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit","kind":"symbol","role":"collection","title":"UIKit","type":"topic","url":"\/documentation\/uikit"},"doc://com.apple.uikit/documentation/UIKit/UILayoutGuide":{"abstract":[{"text":"A rectangular area that can interact with Auto Layout.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"identifier","text":"UILayoutGuide"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UILayoutGuide","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"UILayoutGuide"}],"role":"symbol","title":"UILayoutGuide","type":"topic","url":"\/documentation\/uikit\/uilayoutguide"},"doc://com.apple.uikit/documentation/UIKit/UIView":{"abstract":[{"text":"An object that manages the content for a rectangular area on the screen.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"identifier","text":"UIView"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"UIView"}],"role":"symbol","title":"UIView","type":"topic","url":"\/documentation\/uikit\/uiview"},"doc://com.apple.uikit/documentation/UIKit/UIView/insetsLayoutMarginsFromSafeArea":{"abstract":[{"text":"A Boolean value indicating whether the view’s layout margins are updated automatically to reflect the safe area.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"insetsLayoutMarginsFromSafeArea"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"s:Sb","text":"Bool"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/insetsLayoutMarginsFromSafeArea","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"insetsLayoutMarginsFromSafeArea"}],"role":"symbol","title":"insetsLayoutMarginsFromSafeArea","type":"topic","url":"\/documentation\/uikit\/uiview\/insetslayoutmarginsfromsafearea"},"doc://com.apple.uikit/documentation/UIKit/UIView/safeAreaInsets":{"abstract":[{"text":"The insets that you use to determine the safe area for this view.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaInsets"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsets","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"safeAreaInsets"}],"role":"symbol","title":"safeAreaInsets","type":"topic","url":"\/documentation\/uikit\/uiview\/safeareainsets"},"doc://com.apple.uikit/documentation/UIKit/UIView/safeAreaInsetsDidChange()":{"abstract":[{"text":"Called when the safe area of the view changes.","type":"text"}],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaInsetsDidChange"},{"kind":"text","text":"()"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsetsDidChange()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"safeAreaInsetsDidChange"}],"role":"symbol","title":"safeAreaInsetsDidChange()","type":"topic","url":"\/documentation\/uikit\/uiview\/safeareainsetsdidchange()"},"doc://com.apple.uikit/documentation/UIKit/UIView/safeAreaLayoutGuide":{"abstract":[{"text":"The layout guide representing the portion of your view that is unobscured by bars and other content.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaLayoutGuide"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)UILayoutGuide","text":"UILayoutGuide"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaLayoutGuide","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"safeAreaLayoutGuide"}],"role":"symbol","title":"safeAreaLayoutGuide","type":"topic","url":"\/documentation\/uikit\/uiview\/safearealayoutguide"},"doc://com.apple.uikit/documentation/UIKit/UIViewController/additionalSafeAreaInsets":{"abstract":[{"text":"Custom insets that you specify to modify the view controller’s safe area.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"additionalSafeAreaInsets"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/additionalSafeAreaInsets","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"additionalSafeAreaInsets"}],"role":"symbol","title":"additionalSafeAreaInsets","type":"topic","url":"\/documentation\/uikit\/uiviewcontroller\/additionalsafeareainsets"},"doc://com.apple.uikit/documentation/UIKit/positioning-content-relative-to-the-safe-area":{"abstract":[{"text":"Position views so that they aren’t obstructed by other content.","type":"text"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area","kind":"article","role":"article","title":"Positioning content relative to the safe area","type":"topic","url":"\/documentation\/uikit\/positioning-content-relative-to-the-safe-area"}},"variantOverrides":[{"patch":[{"op":"replace","path":"\/identifier\/interfaceLanguage","value":"occ"},{"op":"replace","path":"\/metadata\/platforms","value":[{"introducedAt":"11.0","name":"iOS"},{"introducedAt":"11.0","name":"iPadOS"},{"introducedAt":"13.1","name":"Mac Catalyst"},{"introducedAt":"11.0","name":"tvOS"},{"introducedAt":"1.0","name":"visionOS"}]},{"op":"replace","path":"\/metadata\/roleHeading","value":"Instance Property"},{"op":"replace","path":"\/metadata\/title","value":"safeAreaLayoutGuide"},{"op":"replace","path":"\/metadata\/symbolKind","value":"property"},{"op":"replace","path":"\/metadata\/fragments","value":[{"kind":"identifier","text":"safeAreaLayoutGuide"}]},{"op":"replace","path":"\/hierarchy","value":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.uikit\/documentation\/UIKit","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView"]]}},{"op":"add","path":"\/topicSections","value":null},{"op":"add","path":"\/relationshipsSections","value":null},{"op":"replace","path":"\/seeAlsoSections","value":[{"anchor":"Getting-the-safe-area","generated":true,"identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsets","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/safeAreaInsetsDidChange()","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIView\/insetsLayoutMarginsFromSafeArea"],"title":"Getting the safe area"}]},{"op":"replace","path":"\/primaryContentSections\/0","value":{"declarations":[{"languages":["occ"],"platforms":["iOS","iPadOS","Mac Catalyst","tvOS","visionOS","watchOS"],"tokens":[{"kind":"keyword","text":"@property"},{"kind":"text","text":" ("},{"kind":"keyword","text":"nonatomic"},{"kind":"text","text":", "},{"kind":"keyword","text":"strong"},{"kind":"text","text":", "},{"kind":"keyword","text":"readonly"},{"kind":"text","text":") "},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UILayoutGuide","kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)UILayoutGuide","text":"UILayoutGuide"},{"kind":"text","text":" * "},{"kind":"identifier","text":"safeAreaLayoutGuide"},{"kind":"text","text":";"}]}],"kind":"declarations"}},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UILayoutGuide\/title","value":"UILayoutGuide"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UILayoutGuide\/fragments","value":[{"kind":"identifier","text":"UILayoutGuide"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UILayoutGuide\/navigatorTitle","value":[{"kind":"identifier","text":"UILayoutGuide"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView\/title","value":"UIView"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView\/fragments","value":[{"kind":"identifier","text":"UIView"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView\/navigatorTitle","value":[{"kind":"identifier","text":"UIView"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1insetsLayoutMarginsFromSafeArea\/title","value":"insetsLayoutMarginsFromSafeArea"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1insetsLayoutMarginsFromSafeArea\/fragments","value":[{"kind":"identifier","text":"insetsLayoutMarginsFromSafeArea"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaInsets\/title","value":"safeAreaInsets"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaInsets\/fragments","value":[{"kind":"identifier","text":"safeAreaInsets"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaInsetsDidChange()\/title","value":"safeAreaInsetsDidChange"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaInsetsDidChange()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"safeAreaInsetsDidChange"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaLayoutGuide\/title","value":"safeAreaLayoutGuide"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIView~1safeAreaLayoutGuide\/fragments","value":[{"kind":"identifier","text":"safeAreaLayoutGuide"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController~1additionalSafeAreaInsets\/title","value":"additionalSafeAreaInsets"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController~1additionalSafeAreaInsets\/fragments","value":[{"kind":"identifier","text":"additionalSafeAreaInsets"}]}],"traits":[{"interfaceLanguage":"occ"}]}]}