{"abstract":[{"text":"Custom insets that you specify to modify the view controller’s safe area.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.uikit\/documentation\/UIKit","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/additionalSafeAreaInsets"},"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)UIViewController(py)additionalSafeAreaInsets","fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"additionalSafeAreaInsets"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"}],"modules":[{"name":"UIKit"}],"navigatorTitle":[{"kind":"identifier","text":"additionalSafeAreaInsets"}],"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":"additionalSafeAreaInsets"},"primaryContentSections":[{"declarations":[{"languages":["swift"],"platforms":["iOS","iPadOS","Mac Catalyst","tvOS","visionOS"],"tokens":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"additionalSafeAreaInsets"},{"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":"keyword","text":"set"},{"kind":"text","text":" }"}]}],"kind":"declarations"},{"kind":"mentions","mentions":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/creating-a-custom-container-view-controller","doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area"]},{"content":[{"anchor":"Discussion","level":2,"text":"Discussion","type":"heading"},{"inlineContent":[{"text":"Use this property to adjust the safe area insets of this view controller’s views by the specified amount. The safe area defines the portion of your view controller’s visible area that is guaranteed to be unobscured by the system status bar or by an ancestor-provided view such as the navigation bar.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"You might use this property to extend the safe area to include custom content in your interface. For example, a drawing app might use this property to avoid displaying content underneath tool palettes.","type":"text"}],"type":"paragraph"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Extending-the-views-safe-area","generated":true,"identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/viewSafeAreaInsetsDidChange()"],"title":"Extending the view’s safe area"}],"variants":[{"paths":["\/documentation\/uikit\/uiviewcontroller\/additionalsafeareainsets"],"traits":[{"interfaceLanguage":"swift"}]},{"paths":["\/documentation\/uikit\/uiviewcontroller\/additionalsafeareainsets"],"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/UIViewController":{"abstract":[{"text":"An object that manages a view hierarchy for your UIKit app.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"identifier","text":"UIViewController"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"UIViewController"}],"role":"symbol","title":"UIViewController","type":"topic","url":"\/documentation\/uikit\/uiviewcontroller"},"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/UIViewController/viewSafeAreaInsetsDidChange()":{"abstract":[{"text":"Called to notify the view controller that the safe area insets of its root view changed.","type":"text"}],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"viewSafeAreaInsetsDidChange"},{"kind":"text","text":"()"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/viewSafeAreaInsetsDidChange()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"viewSafeAreaInsetsDidChange"}],"role":"symbol","title":"viewSafeAreaInsetsDidChange()","type":"topic","url":"\/documentation\/uikit\/uiviewcontroller\/viewsafeareainsetsdidchange()"},"doc://com.apple.uikit/documentation/UIKit/creating-a-custom-container-view-controller":{"abstract":[{"text":"Create a composite interface by combining content from one or more view controllers with other custom views.","type":"text"}],"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/creating-a-custom-container-view-controller","kind":"article","role":"article","title":"Creating a custom container view controller","type":"topic","url":"\/documentation\/uikit\/creating-a-custom-container-view-controller"},"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":"additionalSafeAreaInsets"},{"op":"replace","path":"\/metadata\/symbolKind","value":"property"},{"op":"replace","path":"\/metadata\/fragments","value":[{"kind":"identifier","text":"additionalSafeAreaInsets"}]},{"op":"replace","path":"\/hierarchy","value":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.uikit\/documentation\/UIKit","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController"]]}},{"op":"add","path":"\/topicSections","value":null},{"op":"add","path":"\/relationshipsSections","value":null},{"op":"replace","path":"\/seeAlsoSections","value":[{"anchor":"Extending-the-views-safe-area","generated":true,"identifiers":["doc:\/\/com.apple.uikit\/documentation\/UIKit\/positioning-content-relative-to-the-safe-area","doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIViewController\/viewSafeAreaInsetsDidChange()"],"title":"Extending the view’s 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":") "},{"identifier":"doc:\/\/com.apple.uikit\/documentation\/UIKit\/UIEdgeInsets","kind":"typeIdentifier","preciseIdentifier":"c:@S@UIEdgeInsets","text":"UIEdgeInsets"},{"kind":"text","text":" "},{"kind":"identifier","text":"additionalSafeAreaInsets"},{"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~1UIViewController\/title","value":"UIViewController"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController\/fragments","value":[{"kind":"identifier","text":"UIViewController"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController\/navigatorTitle","value":[{"kind":"identifier","text":"UIViewController"}]},{"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"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController~1viewSafeAreaInsetsDidChange()\/title","value":"viewSafeAreaInsetsDidChange"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.uikit~1documentation~1UIKit~1UIViewController~1viewSafeAreaInsetsDidChange()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"viewSafeAreaInsetsDidChange"}]}],"traits":[{"interfaceLanguage":"occ"}]}]}