Skip to main content

May 16, 2025 Archived

Device Profile Editing

Using Workspace ONE UEM, you can edit a device profile that has already been installed to devices in your fleet. There are two types of changes you can make to any device profile.

  • General – General profile settings serve to manage the profile distribution: how the profile is assigned, by which organization group it is managed, to/from which smart group it is assigned/excluded.
  • Payload – Payload profile settings affect the device itself: Passcode requirement, device restrictions such as camera use or screen capture, Wi-Fi configurations, VPN among others.

Since the operation of the device itself is not impacted, General changes can usually be made without republishing the profile. Saving such changes results in the profile only being pushed to devices that do not have the profile.

Payload changes, however, must always be republished to all devices, new and existing, since the operation of the device itself is affected. If the Assignment Type for the device profile is Optional instead of Auto, then the entire profile must be reinstalled in order for payload updates to be included on the targeted devices.

Edit General Device Profile Settings

General profile settings include changes that manage its distribution only. This distribution includes how the profile is assigned, by which organization group (OG) it is managed, and to/from which assignment group it is assigned/excluded.

This screenshot shows the Devices, Profiles screen list view which enables you to edit the general payload of your device profiles.

  1. Navigate to Resouces > Profiles & Baselines > Profiles.

  2. Locate the profile you want to edit and select its Edit icon (This Edit icon is shpaed like a gray pencil.).

    The only profiles that are editable are those profiles that an organization group (or a child organization group underneath) manages.

    This screenshot shows the edit screen for the general payloads.

  3. Make any changes you like in the General category.

  4. After completing General changes, you can select Save and Publish to apply the profile to any new devices you might have added or removed.

Devices already assigned with the profile do receive the republished profile again. The View Device Assignment screen appears, confirming the list of currently assigned devices.

Edit Payload Device Profile Settings

Payload profile settings include changes that affect the device itself: passcode requirement, device restrictions such as camera use or screen capture, Wi-Fi configurations, VPN among others.

The Add Version button enables you to create an increment version of the profile where settings in the Payload can be modified.

If the Assignment Type for the device profile is Optional instead of Auto, then the entire profile must be reinstalled in order for payload updates to be included on the targeted devices.

This screenshot shows the Credentials payload editing screen with the Add Version button and change version buttons highlighted.

  1. Enable Payload editing that impacts the operation of the device by selecting the Add Version button.

    Selecting the Add Version button and saving your changes means republishing the device profile to all devices to which it is assigned. This republishing includes devices that already have the profile.

  2. After completing Payload changes, select Save and Publish to apply the profile to all assigned devices.

Results: The View Device Assignment screen appears, enabling you to confirm the list of currently assigned devices.

For step-by-step instructions on configuring a specific Payload, refer to the applicable Platform Guide, available on docs.omnissa.com:

See Also: See Add a Device Profile with the new UI for step by step instructions on adding device profiles using the newer UI.

How to Ensure That Devices Get Updates to Optional Profiles

If the Assignment Type for the device profile you want to update is Optional instead of Auto, then the profile with the updated payload must be delivered in another way. There are two alternate ways to ensure that updates to these optional profiles find their way onto devices.

  • Change the Assignment Type for the profile from Optional to Auto.
  • Manually install the updated optional profile.

.

Change Assignment Type from Optional to Auto

You can change the profile's Assignment Type from Optional to Auto, which requires the device to receive the device profile including any and all payload updates.

  1. Navigate to Resources > Profiles & Baselines > Profiles.
  2. Sort or filter the listing, or execute a keyword search to help you locate the profile with the updated payload that you want to change its Assignment Type.
  3. Select the Edit icon (this edit icon is in the shape of a pencil) next to the profile listing. The Edit Profile screen displays.
  4. Select the Add Version button in the lower-left corner.
  5. Select the Next button.
  6. For Assignment Type, change this setting from Optional to Auto.
  7. Select the Save & Publish button. Since this profile is no longer Optional, it is now treated as an Auto profile which installs itself upon the next device check-in.

.

Manually Install Optional Profiles

If changing the Assignment Type for your device profile from optional to auto is not an option for your environment, the only other option is to manually install the optional profile with the updated payload on each device.

  1. Navigate to Resources > Profiles & Baselines > Profiles.

  2. Sort or filter the listing, or execute a keyword search to help you locate the profile with the updated payload that you want to install manually.

  3. Locate the Installed Status column in the listing and select the View link that corresponds to your optional profile. A popup displays with device counts for Not Installed, Installed, and Assigned.

    this screenshot shows the Profiles list view with the Installed Status popup, giving you access to devices that have the profile installed.

  4. Select the Installed count. The View Devices screen for the selected profile displays.

    On this screen you can find all the devices, listed by friendly name, that have the optional profile in question installed.

  5. Right-click the friendly name of the next device in the list and open in a new tab or new window. Switch to the new tab or new window, which shows the Details View for the device you right-clicked.

  6. From the Details View for the device, select the Profiles tab.

  7. Locate the name of the profile. Refer to the previous tab or window to refresh your memory.

  8. Select the radio button to the left of the profile name. You can now see new buttons at the top of the listing.

  9. Select the Install button and confirm the selection.

  10. Close the tab or window containing the Details View, since you are now done with this device.

  11. Repeat steps 5-10 until all the devices in the installed list have the new updated profile installed.

  12. Once the last device in the listing has seen a manual installation of the profile, close the View Devices screen.

If you have other optional profiles you must reinstall to capture updated payloads, repeat this task as many times as is required.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…