
Create a Custom configuration in Apple Business
You can add many different payloads and restrictions for iPhone, iPad, Mac, Apple TV, and Apple Vision Pro devices using a Custom Configuration. You do this by creating your own configuration profiles, then adding them to Apple Business. To see examples of XML code for payloads, see Profile-Specific Payload Keys on the Apple Developer website, select a payload from the Topics list, then scroll down to view the profile example for that specific payload. You can also create some configuration profiles with Apple Configurator for Mac. To do so, download and launch Apple Configurator, then choose New Profile from the File menu.
The configuration profile file you create needs to meet the following requirements:
Use the .mobileconfig file extension.
Be less than 1 MB in size.
Contain at least one common platform among all payloads included.
In Apple Business, sign in with a user whose role has permissions to create, edit, and delete device configurations.
To view roles and permissions, see Intro to roles and permissions.
In your browser, choose Devices > Configurations > All Configurations.
Select All Configurations, select Add
next to Custom
, then enter a name for the configuration.Choose one of the following:
Choose File, navigate to the folder where the file is located, then select Upload.
Drag the file into the “Upload your profile” area.
Note: Any issues in the configuration profile are listed, and needs to be fixed before it can be saved. If you receive an error, check that the profile contains at least one correctly formatted payload.
Select which operating systems you want this configuration profile to be used with.
If a profile contains more than one payload for different operating systems (for example):
Payload 1: iOS/iPadOS, macOS, tvOS, visionOS
Payload 2: iOS/iPadOS, macOS, tvOS
Payload 3: iOS/iPadOS, macOS
Payload 4: iOS/iPadOS
The profile can be installed only on the common operating system (in this example, iOS/iPadOS).
If necessary, add a note about the configuration profile.
Select Next to view the payloads included in the profile and any information about them.
Notices about a payload or the keys within a payload can include:
Minimum operating system version requirements (if later than iOS 15, iPadOS 15, or macOS 12)
Supervision or enrollment requirements
Platform requirements
If necessary, select View Payload XML to view the contents of any individual payload, or select View Profile XML to view the contents of the profile.
Select Save.