> For the complete documentation index, see [llms.txt](https://docs.cubilock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cubilock.com/profile-management/kiosk-settings/setup-actions.md).

# 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.

<figure><img src="/files/VuOTqbgZatqGZdie9eJN" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="/files/Q8VFbADJQBpYdUyYQ2Zc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/XqKa0ObidN5CecWKT87s" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NZ3VkyUySHpFzU2hF2sI" alt=""><figcaption></figcaption></figure>