If you're new to iMazing Profile Editor, then you are on the right page! We've gathered below the most important information to get you up and running quickly with it.
iMazing Profile Editor is an application for both macOS and Windows, available free of charge on our website, on the Mac App Store, and on the Microsoft Store:
Configuration profiles are XML property list files that allow system administrators to deploy various presets, preferences, restrictions, and more onto Apple macOS, iOS, iPadOS and tvOS devices.
iMazing Profile Editor lets users create, modify, and also digitally sign configuration profiles with a friendly user interface instead of manually coding them in XML.
The app contains definitions for all of Apple's configuration options, as well as for a large number of popular third party applications. These are displayed as configuration pages where users can enter their desired settings.
Configuration options are grouped under domains (e.g. Wi-Fi, Mail, Calendar) and each group is written to a profile as a configuration payload. Profiles can contain multiple payloads of differing domains, and where supported, of the same domain.
The sidebar lists all available sections, grouped under System, Application, and User Domain (when set). Select a section and click Add Configuration Payload to add it to the current profile. You can also click the + button on the toolbar, press ⇧⌘A on the keyboard, or double-click the section in the sidebar.
A few domains support multiple payloads, for example the Calendar domain. You can tell these domains apart by looking at the toolbar + button, which on these domains will remain active after the first payload has been added.
Note that individual payloads can be collapsed and renamed for clarity.
To remove a payload from the profile, click the - button or press ⇧⌘R on the keyboard. You may have to scroll back to the top of the payload to see the button.
When you add a payload to a profile, the preference properties that can be set for the payload's domain are displayed as fields for you to set values on. Some fields may be conditionally disabled or even hidden, depending on data already entered in other fields, to avoid conflicts or clutter.
Most properties on a newly added payload will not have a value set on them. By interacting with a property's field (entering text, making a selection, toggling a checkbox) you are setting a value on that property. Having a value set for a certain property is indicated by a small blue circle adjacent to the property's title.
Clicking on the blue indicator, or right-clicking in a property's area, brings up a context menu that allows, where supported, completely unsetting a property's value, forcing a default value, or forcing an empty value.
Like most other properties, booleans start with no value set (even though their checkboxes usually display the property's default value) and only get a value set once interacted with. However, by default, toggling a boolean property's checkbox back to the default value will unset the value from the property altogether.
This behavior can be changed in the Preferences windows under the Defaults section.
💡 Tip: You can force a default value on a checkbox using the checkbox's context menu or by clicking it while the Option (⌥) or Alt key is held down.
The search field filters available sections, and highlights matching preference properties. Sections are matched by title, description, and domain, and properties by title, name, and description.
You can search for properties by name even when the property names are not set to be displayed. Preference properties which are conditionally hidden but match your search will also temporarily appear.
The three platform buttons on the toolbar let you filter sections and properties by compatible OS.
You can select multiple platforms, in which case only sections supporting all selected platforms are shown.
Use the circle button on the toolbar to display only sections and properties that are already configured, and that are therefore going to get written to the profile. You can also press ⌥⌘0 on the keyboard.
You can choose to show or hide the key names of all properties by selecting Property Names in the View menu, or by pressing ⌥⌘N on the keyboard.
The app generates standard Apple configuration profile .mobileconfig files, which are ready for loading locally or for pushing to users via MDM solutions. They are also compatible with any first- or third-party software that also conforms to the standard.
If you have iMazing installed, you could also save profiles to the iMazing Library and manage profiles on fleets of devices when you use iMazing Configurator. Simply select the Save to iMazing Library menu option to save profiles there directly.
In general, only preference properties that have a value set on them as indicated by the blue indicator circle next to the property's title, will get written to the profile file on save. This is especially true for fields which can be perceived to have a value when they do not, like selection boxes whose No Value item is selected or boolean fields.
It is possible to save profiles even if some preference keys contain invalid values. For example, if a value is missing on a required preference key, a red error mark will be displayed, but the profile can still be saved.
The option to cryptographically sign a profile with a certificate is available from within the app. On macOS, you can select a certificate stored in Keychain from a list available on the save dialog. Similarly on Windows, you can select a certificate stored in Certificate Manager from a list available when selecting the Save As Signed… item from the File menu.
If you already saved a profile without signing and wish to sign it, select either the Save As… item from the File menu on the Mac or the Save As Signed… item from the same menu on the PC, to bring that option up again.
Profiles already saved with a signature, will be saved again using the same signing identity without prompting the user, provided that the identity exists on the computer.
Certain third-party MDM solutions accept settings in domain-specific .plist files instead of configuration profiles. iMazing Profile Editor provides the ability to export preferences that you define in any payload into such files. To do so, select the section you wish to export and choose Export Configuration Payload as Plist from the File menu.
On sections with more than one configured payload, a sheet will show and allow you to choose the exact payloads to be exported.
iMazing Profile Editor supports adding custom manifest files provided by the user in PFM format. Users should place these files in one folder of their choice, and point to that folder in the Preferences window of the app.
Any profile window currently open will not reflect the change, as they may contain payloads which rely on the previous state. To see your custom manifests in the sections list, open a new profile window.
Congratulations, you've successfully gone through our Getting Started guide!
For more information about creating configuration profiles, head over to our Create or edit Configuration Profiles for iOS, macOS, or tvOS guide.
We hope that this introduction helped you. If you need help, don't hesitate to contact us.