Setup Actions

In the Kiosk Settings tab of the Edit Device Profile screen, the Setup Actions section lets you define a one‑time automated action that will execute when a device is being provisioned (during or immediately after enrollment). This is especially useful for kicking off companion apps, onboarding workflows, or configuration assistants that must run before the user can fully use the device.

Navigation

Device Management → Device Profiles → Edit Profile → Kiosk Settings → Setup Actions

What Setup Actions Are

Setup Actions are one‑off procedures that run during the initial setup of a device. These actions are executed as part of the Android Enterprise provisioning process and occur before the user reaches the home screen or main UI. In most cases, they launch a designated app that helps complete device configuration or onboarding.

In Android Enterprise (via the Android Management API), the underlying policy field that governs this behavior is called setupActions, which determines which actions (such as launching an app) are executed during setup. Only one Setup Action is allowed per profile.

Setup Action Fields Explained

Field	Description
Launch App	The application that will be automatically started during setup. To use this, the app must be included in the profile’s app list and marked as Required for Setup.
Title	A short label or name for the action that may be shown during provisioning.
Description	Optional text explaining the action — this can help users understand what the action does during setup.
Launch Mode	Determines when the action will run:
During Enrollment	Runs during the enrollment flow before the user finishes setting up the device.
After Enrollment	Runs just after enrollment completes, once the policy is applied.
Both	Runs once during enrollment and again immediately after.

How It Works in Practice

To successfully run a Setup Action:

1. Add the App to the Profile: Include the app in the device profile’s Applications list.

2. Mark as Required for Setup: From the Install Type dropdown for the app, choose Required for Setup. This tells Android that this app must be installed and launched during device provisioning.

3. Create a Setup Action: In Setup Actions, click New Setup Actions → select the app → enter a Title & Description → choose a Launch Mode → click Add.

4. Save the Profile: Save and apply the profile so that when new devices enroll, the Setup Action runs as configured.