Priority Deployments let you control the order in which Device Settings and Smart Software items are deployed to a device, ensuring critical software and settings are installed before anything else. This includes the ability to deploy items during the Pre-Enrollment stage of Automated Device Enrollment — holding a device in Setup Assistant until essential configurations are in place before the user completes onboarding.
Policy Priorities
When a Policy deploys, all items are sorted and deployed in order of their priority ranking. Priority values range from 0.1 to 19.9 — lower numbers deploy first. The following are the default priority values for common catalog item types:
| Catalog Item | Default Priority |
|---|---|
| Facts | 2 |
| Self Service | 2 |
| Splashtop | 5 |
| Software | 10 |
| OS Users | 10 |
| System Updates | 20 |
How to Set a Custom Priority
Installation priority can be configured on individual Smart Software items and Device Settings in the Catalog.
- Navigate to Catalog and click Edit on the item you want to modify.
- Locate the Installation Priority or Priority Order field:
- For Smart Software: the field appears below the Installation Command.
- For Device Settings: the field appears at the bottom of the edit form.
- For Smart Software: the field appears below the Installation Command.
- Enter a priority value between
0.1and19.9and save your changes.
For example, Custom Facts deploy at priority 2. To deploy a software item before Custom Facts, assign it a value between 0.1 and 1.9. To deploy it last, assign it 19.9.
Pre-Enrollment Deployments
Pre-Enrollment Deployments work with Apple's Automated Device Enrollment (ADE) to hold a device in Setup Assistant until specific software and Device Settings have been successfully installed. Once those items deploy, the device continues through the setup flow. This ensures critical configurations are in place before the user begins their onboarding experience.
Note: Large pre-enrollment deployments can delay the enrollment experience. Only include items that are truly essential at this stage.
Step 1: Configure Automated Device Enrollment
In your ADE Enrollment Settings, enable the following setting:
- Await Device Configured — Holds the device in Setup Assistant until Addigy confirms that the specified items have been deployed.
Step 2: Set Pre-Enrollment Priority Values
On each Smart Software item or Device Setting you want to deploy during pre-enrollment, set the Installation Priority to a value between 0.1 and 1 (for example, 0.1, 0.2, 0.5). Any item in this range will be included in the pre-enrollment deployment group.
Once both steps are complete, any new device enrolling through ADE will have those items installed before the user reaches the Setup Assistant screen.