{"abstract":[{"text":"The insets that you use to determine the safe area for this view.","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\/safeAreaInsets"},"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)safeAreaInsets","fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaInsets"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"}],"modules":[{"name":"UIKit"}],"navigatorTitle":[{"kind":"identifier","text":"safeAreaInsets"}],"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":"safeAreaInsets"},"primaryContentSections":[{"declarations":[{"languages":["swift"],"platforms":["iOS","iPadOS","Mac Catalyst","tvOS","visionOS"],"tokens":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaInsets"},{"kind":"text","text":": "},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIEdgeInsets","kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"},{"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":"The safe area of a view reflects the area not covered by navigation bars, tab bars, toolbars, and other ancestors that obscure a view controller’s view. (In tvOS, the safe area reflects the area not covered by the screen’s bezel.) You obtain the safe area for a view by applying the insets in this property to the view’s bounds rectangle. If the view is not currently installed in a view hierarchy, or is not yet visible onscreen, the edge insets in this property are ","type":"text"},{"code":"0","type":"codeVoice"},{"text":".","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"For the view controller’s root view, the insets account for 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 insets reflect only the portion of the view that is covered. For example, if a view is entirely within the safe area of its superview, the edge insets in this property are ","type":"text"},{"code":"0","type":"codeVoice"},{"text":".","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"You might use this property at runtime to adjust the position of your view’s content programmatically.","type":"text"}],"type":"paragraph"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Related-Documentation","identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIScreen\/overscanCompensationInsets"],"title":"Related Documentation"},{"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\/safeAreaLayoutGuide","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\/safeareainsets"],"traits":[{"interfaceLanguage":"swift"}]},{"paths":["\/documentation\/uikit\/uiview\/safeareainsets"],"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/UIEdgeInsets":{"abstract":[{"text":"The inset distances for views.","type":"text"}],"fragments":[{"kind":"keyword","text":"struct"},{"kind":"text","text":" "},{"kind":"identifier","text":"UIEdgeInsets"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIEdgeInsets","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"UIEdgeInsets"}],"role":"symbol","title":"UIEdgeInsets","type":"topic","url":"\/documentation\/uikit\/uiedgeinsets"},"doc://com.apple.uikit/documentation/UIKit/UIScreen/overscanCompensationInsets":{"abstract":[{"text":"The edge inset values needed to avoid clipping the rectangle.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"overscanCompensationInsets"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIScreen\/overscanCompensationInsets","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"overscanCompensationInsets"}],"role":"symbol","title":"overscanCompensationInsets","type":"topic","url":"\/documentation\/uikit\/uiscreen\/overscancompensationinsets"},"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":"safeAreaInsets"},{"op":"replace","path":"\/metadata\/symbolKind","value":"property"},{"op":"replace","path":"\/metadata\/fragments","value":[{"kind":"identifier","text":"safeAreaInsets"}]},{"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":"Related-Documentation","identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIScreen\/overscanCompensationInsets"],"title":"Related Documentation"},{"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\/safeAreaLayoutGuide","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":"readonly"},{"kind":"text","text":") "},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIEdgeInsets","kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"},{"kind":"text","text":" "},{"kind":"identifier","text":"safeAreaInsets"},{"kind":"text","text":";"}]}],"kind":"declarations"}},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIEdgeInsets\/title","value":"UIEdgeInsets"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIEdgeInsets\/fragments","value":[{"kind":"identifier","text":"UIEdgeInsets"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIEdgeInsets\/navigatorTitle","value":[{"kind":"identifier","text":"UIEdgeInsets"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIScreen~1overscanCompensationInsets\/title","value":"overscanCompensationInsets"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIScreen~1overscanCompensationInsets\/fragments","value":[{"kind":"identifier","text":"overscanCompensationInsets"}]},{"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"}]}]}