Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.
SafeAreaCompatibility
This enum describes the automatic compatibility transformations that apply to descendant "fullscreen" GuiObjects of a ScreenGui on displays with screen cutouts.
Items
| Name | Value | Description |
|---|---|---|
| None | 0 | Do not apply compatibility transformations to any descendants of the ScreenGui. |
| FullscreenExtension | 1 | If the total area of any descendant GuiObject within the ScreenGui (including any applied border or UIStroke) covers the device's safe area both horizontally and vertically, its background area will be expanded to cover the fullscreen area. This expansion does not affect the size or position of the descendant's content, except in the case of ImageLabel, ImageButton, or VideoFrame where the image/video is considered part of the background and will be expanded to fullscreen. Note that this option is intended to automatically improve the appearance of UI that was authored for screens without any cutouts. However, it's recommended that you avoid fullscreen extensions for new work; instead, use the ScreenInsets property to specify which insets should be respected for different ScreenGuis. |
None
Do not apply compatibility transformations to any descendants of the ScreenGui.
| Field | Value |
|---|---|
| value | 0 |
FullscreenExtension
If the total area of any descendant GuiObject within the ScreenGui (including any applied border or UIStroke) covers the device's safe area both horizontally and vertically, its background area will be expanded to cover the fullscreen area. This expansion does not affect the size or position of the descendant's content, except in the case of ImageLabel, ImageButton, or VideoFrame where the image/video is considered part of the background and will be expanded to fullscreen.
Note that this option is intended to automatically improve the appearance of UI that was authored for screens without any cutouts. However, it's recommended that you avoid fullscreen extensions for new work; instead, use the ScreenInsets property to specify which insets should be respected for different ScreenGuis.
| Field | Value |
|---|---|
| value | 1 |