More

    How to Use Custom Payload on Apple Devices via MDM

    Share On

    In large organizations, the configuration of large device inventory is a pain point for IT teams. Especially when the devices are to be configured over-the-air, streamlining the process of setting up a large number of devices can be complex and cumbersome. 

    Custom Payload for Apple devices
    Custom Payload for Apple devices

    Scalefusion enables customization and configuration of profile settings via a Custom Payload. IT teams can configure a custom calendar and email settings, Wi-Fi and VPN settings, digital certificates for authentication as well as device restrictions using Scalefusion custom payload. 

    This is achieved by using the custom settings feature available under the iOS and macOS device profile on the Scalefusion dashboard. IT teams can make use of a top-notch XML editor and push the custom payload directly onto the devices. This helps IT admins to fine-tune configuration settings to the T, helping to leverage settings that are not available on the Scalefusion dashboard. Using Scalefusion, IT admins can push more than one payload in the same XML file For example, Custom Payload for Wi-Fi and email can be pushed via the same XML file.

    In this article, let us discuss how the profile configuration can be achieved for device profiles on macOS and iOS devices. The payloads are to be created in the XML format based on the developer guidelines by Apple. 

    Custom Payload settings for iOS

    Step 1

    Navigate to the Device Profile section of the dashboard. Select the iOS device profile to which you want to push custom settings. Choose the restrictions in the custom settings of the profile section.

    Custom payload settings via Scalefusion dashboard for iOS
    Custom payload settings via Scalefusion dashboard for iOS step 1

    If the custom payload settings that you upload conflict with the Device Profile settings created in the Device Profile section, you can resolve these conflicts by selecting either of the two options- you can choose: 

    • Custom Payload Wins over Device Profile Settings: With this configuration, the settings in the Custom Payload are given precedence over the Device Profile settings.
    • Device Profiles Wins over Custom Payload: Under this configuration, settings in the Device Profile are given precedence over Custom Payload.

    Step 2

    Upload the custom payload by importing the custom payload file or by typing in the custom payload in the existing XML editor.

    Custom payload settings via Scalefusion dashboard for iOS
    Custom payload settings via Scalefusion dashboard for iOS step 2

    Step 3

    Once you enter the payload, you can click on the validate option to validate the payload. If the payload is successfully uploaded without any syntactic/validation issues, a green tick appears on the top right corner of the editor. If there are any errors within your custom payload, a red cross appears. 

    Custom payload settings via Scalefusion dashboard for iOS
    Custom payload settings via Scalefusion dashboard for iOS step 3

    Now, click on the update profile button to save your custom payload configuration and the settings will be automatically pushed onto the iOS devices configured with the said Device Profile. 

    Now, click on the update profile button to save your custom payload configuration and the settings will be automatically pushed onto the iOS devices configured with the said Device Profile. 

    Custom Payload settings for macOS

    The process to configure custom payload settings for macOS is similar to that of iOS.

    Step 1

    Navigate to the Device Profile section of the chosen macOS profile on the Scalefusion dashboard. Select the custom settings options available in the right column.

    On macOS devices, specific payloads can be applied only at the user level. Use the toggle button to enable the payload application on the user end. If this option is not chosen, the payload is sent on the device channel and is applied to all the users on the device.

    Custom payload settings via Scalefusion dashboard for macOS
    Custom payload settings via Scalefusion dashboard for macOS step 1

    Step 2:

    The process for conflict resolution, importing the custom payload file or editing it within the XML editor is similar to that of iOS. After you validate the custom payload file, a green tick appears if there are no errors.

    set custom payload settings
    Custom payload settings via Scalefusion dashboard for macOS step 2

    Once validated, click on the save button to save the Device Profile settings. These will be then applied to the devices enrolled with the said Device Profile.

    Closing lines…

    Custom Payload configuration via Scalefusion Apple MDM helps IT admins in quickly pushing settings across multiple devices. This adds to Scalefusion’s prime offering of demystifying IT tasks and reducing the complexity of managing a large device inventory. 

    Renuka Shahane
    Renuka Shahane
    Renuka Shahane is a writer and editor at Scalefusion blog. An avid reader who loves writing about technology, she likes translating technical jargon into consumable content.

    Product Updates

    spot_img

    Latest Articles

    Co-management for Windows devices: Meaning, challenges and solution

    Managing Windows devices has never been straightforward. As organizations transition from on-premise infrastructures to modern cloud-based solutions, IT admins face a crucial challenge—how to...

    How web filtering improves security for businesses

    Cybercrime is no longer a distant threat; it's a daily reality. In 2023, the average data breach cost reached $4.45 million, with a significant...

    XProtect on Mac: Apple’s built-in security shield

    Is "Macs are untouchable" a statement or a question? Well, that depends. Every Mac user relies on Apple’s built-in defenses, but threats keep rising...

    Latest From Author

    Expert Insights from Our Webinar: Mastering Windows Patch Management with Scalefusion UEM

    Keeping Windows devices secure and compliant has never been more critical—or more challenging. According to a study conducted by the Poneman Institute, 60% of...

    How to lockdown Windows devices in Multi-app kiosk mode?

    Windows devices dominate the desktop market, with Windows 10 still leading at around 65% market share as of July 2024. While Windows 11 adoption...

    What is Windows Autopilot: A Step-by-Step Admin’s Guide

    As businesses move towards a digitally equipped infrastructure that incorporates modern technologies like Windows autopilot while maintaining user preference and ease of use to...

    More from the blog

    Co-management for Windows devices: Meaning, challenges and solution

    Managing Windows devices has never been straightforward. As organizations transition from on-premise infrastructures to modern cloud-based solutions, IT admins face a crucial challenge—how to...

    XProtect on Mac: Apple’s built-in security shield

    Is "Macs are untouchable" a statement or a question? Well, that depends. Every Mac user relies on Apple’s built-in defenses, but threats keep rising...

    Custom Android devices: Everything you need to know in 2025

    In 2025, Android still continues to dominate the global mobile operating system landscape, boasting a user base exceeding 3.3 billion and capturing 71.85% of...

    [Infographic] Apple device management simplified with Scalefusion UEM

    Apple devices are a dream to use but a nightmare to manage if IT doesn’t have the right tools. One wrong move, and the dream...