2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

AppLifecycleManagerState

Reports the application lifecycle state returned by AppLifecycleObserverService:GetCurrentState() and related events. Transitions follow AppLifecycleManagerState.Detached → AppLifecycleManagerState.Active → AppLifecycleManagerState.Inactive → AppLifecycleManagerState.Hidden → AppLifecycleManagerState.Detached; intermediate states are traversed automatically when the application jumps between non-adjacent states.

Items

NameValueDescription
Detached0The application has not yet started or is shutting down. This is the initial state before the lifecycle manager is created and the final state entered during application termination.
Active1The application is in the foreground and has input focus. This is the normal running state where the user is actively interacting with the experience.
Inactive2The application is visible but does not have input focus. On iOS this occurs during transitions such as incoming calls or notification center pull-down; on macOS it corresponds to the application resigning active status.
Hidden3The application is fully in the background and not visible to the user. On mobile platforms this corresponds to the app being backgrounded; on desktop it corresponds to the window being minimized or fully occluded.

Detached

The application has not yet started or is shutting down. This is the initial state before the lifecycle manager is created and the final state entered during application termination.

FieldValue
value0

Active

The application is in the foreground and has input focus. This is the normal running state where the user is actively interacting with the experience.

FieldValue
value1

Inactive

The application is visible but does not have input focus. On iOS this occurs during transitions such as incoming calls or notification center pull-down; on macOS it corresponds to the application resigning active status.

FieldValue
value2

Hidden

The application is fully in the background and not visible to the user. On mobile platforms this corresponds to the app being backgrounded; on desktop it corresponds to the window being minimized or fully occluded.

FieldValue
value3