You can edit custom configuration profiles directly in the Catalog to update keys and arrays without recreating the profile from scratch. This helps you keep existing configurations up to date while preserving their deployment history and assignments.
How to Edit a Custom Profile
Use this workflow when you need to change keys, values, or arrays inside an existing custom configuration profile.
- Navigate to Catalog > Device Settings.
- Locate your custom configuration profile and click Actions (…) > Edit.
- In the editor, enable the raw XML view by toggling the Show raw XML button.
- In the XML field, update the arrays, keys, and values you want to change while keeping the required payload fields intact.
- When you are finished editing, click Save and Confirm.
After you confirm the changes, the new version of the profile will deploy to assigned devices on the next policy deployment cycle.
Note: When you edit a custom profile that was originally signed by another tool, Addigy removes the original signature and re-signs the profile with Addigy’s own signing certificate when it is deployed.
Required Payload Fields
Some payload fields must remain in the profile so it can be validated and deployed correctly by MDM.
PayloadUUIDPayloadIdentifierPayloadVersion
Do not remove or rename these required fields when editing raw XML; removing them can cause the profile to fail validation or deployment.
Special Characters in XML
When you edit raw XML, certain characters must be escaped so the XML remains valid.
-
&→& -
"→" -
'→' -
<→< -
>→>
If you paste content that includes these characters without escaping them, the profile may not save or may fail to deploy because the XML cannot be parsed.
Frequently Asked Questions
What happens to the signature when I edit a signed profile?
If the custom profile was signed by another platform or tool, Addigy removes that signature when you edit it and re-signs the profile with Addigy’s signature when it is deployed. This ensures that devices recognize the profile as coming from your Addigy MDM server.
When will my changes reach devices?
Once you save and confirm your changes, the updated profile is queued for deployment to any devices or policies that have the profile assigned. Devices receive the updated configuration during their next MDM check-in or policy deployment interval, or sooner if you trigger a manual deployment from the policy or GoLive page.