barscaret-downcaret-leftcaret-rightcaret-upcheckchevron-leftchevron-rightfile-pdfinfosign-in-altsignin text-widthtimesyoutube

macOS > Device Data & Configuration

Custom configuration profiles for Macs

Updated on July 7th, 2021

You can configure your Macs easily and remotely using Miradore's built-in configuration profiles. In addition, you can customize or extend the management capabilities by creating custom configuration profiles.

Good to know

Apple configuration profiles can be either device or user-specific. You can create custom configuration profiles using the Apple profiles whose type is macOS device. But currently, Miradore custom profiles are not compatible with the macOS user configuration profiles.

For more information about the profiles types and what can be configured with the custom profiles, check the Complete MDM payload list on Apple's website.


  • Miradore Premium plan
  • An Administrator role on Miradore
  • Apple Configurator 2 or Profile Manager

How to create a custom configuration profile

  1. Start building a custom profile by creating a .mobileconfig file using Apple Configurator 2, Profile Manager, or another third-party software. For instructions, refer to Apple's documentation.
  2. Go to Management > Configuration profiles page on Miradore and click Add > macOS > Advanced (custom).Custom configuration profile for iOS
  3. Upload your .mobileconfig file or copy-paste its contents to the profile.
    • Notice that Miradore uses only the payload contents (inside PayloadContent-array) of the .mobileconfig file. Other XML contents are skipped.
    • Notice also that you can use variables within the configuration profiles to handle data dynamically. The variables are available in the Add variables drop-down menu. In the example below, we use the $SerialNumber$ variable to show the device's serial number on the login screen.Custom configuration with a variable
  4. Enter a name and a description for the profile.Custom configuration profile for macs
  5. Now you're ready to deploy the configuration profile to your devices.


If your configuration profiles aren't working on the devices as expected, you should check the Configuration Profile Reference and Mobile Device Management Protocol Reference documents on the Apple Developer website and ensure that your devices meet the operating system version requirements.

  • This field is for validation purposes and should be left unchanged.

Previous Article: