iMazing Manual
Category

iMazing Manual


Getting started with iMazing Profile Editor

Getting started with iMazing Profile Editor

iMazing Profile Editor Screenshot

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.

  1. Download and install iMazing Profile Editor
  2. How does iMazing Profile Editor work?
  3. Adding Configuration Payloads
  4. Removing Configuration Payloads
  5. Entering Data
  6. Display Filters and Search
  7. Saving Profiles
  8. Signing Profiles
  9. Exporting Payloads to Plist
  10. User Provided Manifests



1. Download and install iMazing Profile Editor

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:

2. How does iMazing Profile Editor work?

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.

3. Adding Configuration Payloads

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.

iMazing Profile Editor Screenshot – Add Configuration Payload

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.

iMazing Profile Editor Screenshot – Renaming a Payload

Note that individual payloads can be collapsed and renamed for clarity.

4. Removing Configuration Payloads

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.

5. Entering Data

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 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 title.

Clicking on the blue indicator, or right-clicking in a property area, brings up a context menu that allows, where supported, completely unsetting the property value, forcing a default value, or forcing an empty value.

Checkboxes behavior

Like most other properties, booleans start with no value set (even though their checkboxes usually display their 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 window under the Defaults section.

iMazing Profile Editor Preferences Window

💡 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.

6. Display Filters and Search

Deep Search

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.

iMazing Profile Editor Screenshot – Deep Search in Action

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.

Supported platforms filter

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.

iMazing Profile Editor Screenshot – Platform Filters Visible

View configured sections and properties only

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.

View Property Names

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.

7. Saving Profiles

Standard format

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.

Set and unset properties

In general, only preference properties that have a value set on them as indicated by the blue indicator circle next to the property 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.

Invalid 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.

8. Signing Profiles

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.

9. Exporting Payloads to Plist

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.

iMazing Profile Editor – Export Configuration Payloads

On sections with more than one configured payload, a sheet will show and allow you to choose the exact payloads to be exported.

10. User Provided Manifests

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.

iMazing Profile Editor – Preferences Window, General tab

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.