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

macOS > Device Data & Configuration

Custom configuration profiles for Macs

Updated on February 16th, 2023

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.

Important information

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 profile types and what can be configured with the custom profiles, check the Complete MDM payloads for Mac computers or the document Profile-Specific Payload Keys on Apple's website.


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.
    • Please note 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.
  • If the syntax doesn't work please double-check that the quotation marks are of the correct type. If required you can find and replace them using Notepad. See the example below.

You can replace quotation marks with the correct type with the help of Notepad.

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

Previous Article: