Payload interaction

When you apply several different payloads to a device, the settings interact in a variety of ways.

Combined payloads

Combined payload items aren’t mutually exclusive. These payload items are concatenated together, keeping all the payload items. Combined payloads are usually things like mail or LDAP accounts, where the existence of one doesn’t preclude additional accounts.

Multiple payloads of the same kind can be applied to a device. If payloads contain account, certificate, or network configurations, each of the payloads’ configurations are applied simultaneously. Some network payloads may conflict with others. If two payloads define different network settings for the same SSID, for example, the result is undefined. However, iOS payloads containing restrictions don’t conflict. Instead, the most restrictive value of each restriction is applied. In OS X, most combined payload’s restrictions settings (versus account settings) are undefined if more than one value exists in multiple payloads.

You can use combined payloads to add usage restrictions together to form a restrictive environment where the user has very limited options on what can be used on the device.

Exclusive payloads

Exclusive payloads can only be applied once. These payloads have only one version of the setting possible, like device names, password policies, or specific network settings. For example, a device can’t simultaneously have more than one global HTTP proxy. Any duplicate payload settings overwrite previous settings.

If payloads contradict each other, the more restrictive setting is normally used. In some cases, the result is undefined.

Note: On iOS, if combined payloads have the same account description (or display name), they’re treated as exclusive payloads.

Payload categories and interaction

The following table shows the available payloads, how they can be applied, and whether they’re exclusive, combined, or other.

Payload

OS X and iOS

iOS only

OS X only

General settings icon General

Exclusive

 

 

Certificate settings icon Certificate

Combined

 

 

Fonts settings icon Fonts

Combined

 

 

Network settings icon Network

Combined

 

 

passcode settings icon Passcode

Combined

 

 

SCEP settings icon SCEP

Combined

 

 

Security & Privacy settings icon Security & Privacy

Varies

 

 

VPN settings icon VPN

Combined

 

 

AirPlay settings icon AirPlay

 

Combined

 

AirPrint settings icon AirPrint

 

Combined

 

APN settings icon APN

 

Exclusive

 

APN settings icon App Configuration

 

Combined

 

APN settings icon OS X Server Accounts

 

Combined

 

APN settings icon Network Usage Rules

 

Exclusive

 

Calendar settings icon Calendar

Combined (user)

Combined (device)

 

Contacts settings icon Contacts

Combined (user)

Combined (device)

 

Exchange settings icon Exchange

Combined (user)

Combined (device)

 

Global HTTP Proxy settings icon Global HTTP Proxy

 

Exclusive

 

LDAP settings icon LDAP

Combined (user)

Combined (device)

 

Mail settings icon Mail

Combined (user)

Combined (device)

 

iOS restrictions settings icon Restrictions (iOS)

 

Exclusive

 

Single App Mode settings icon Single App Mode

 

Exclusive

 

Single Sign-on settings icon Single Sign-on

 

Exclusive

 

Subscribed calendars settings icon Subscribed Calendars

 

Combined

 

Web Clips settings icon Web Clips

Combined (user)

Combined (device)

 

Content Filter settings icon Content Filter

 

Combined

 

Domains settings icon Domains

 

Combined

 

Accessibility settings icon Accessibility

 

 

Combined

AD Certificate settings icon AD Certificate

 

 

Exclusive

Custom settings icon Custom Settings

 

 

Combined

Directory settings icon Directory

 

 

Exclusive

Dock settings icon Dock

 

 

Combined

Energy Saver settings icon Energy Saver

 

 

Combined

Finder settings icon Finder

 

 

Combined

Identification settings icon Identification

 

 

Exclusive

Login Items settings icon Login Items

 

 

Combined

Login Window settings icon Login Window

 

 

Combined

Messages settings icon Messages

 

 

Combined

Mobility settings icon Mobility

 

 

Combined

Parental Controls settings icon Parental Controls

 

 

Combined

Printing settings icon Printing

 

 

Combined

Proxy settings icon Proxies

 

 

Exclusive

OS X Restrictions settings icon Restrictions (OS X)

 

 

Exclusive

Software Update settings icon Software Update

 

 

Combined

Time Machine settings icon Time Machine

 

 

Combined

Xsan settings icon Xsan

 

 

Exclusive

Interaction with Open Directory

OS X payloads may behave differently when they interact with Open Directory settings:

  • Managed device-applied user profiles take priority over Open Directory-stored user settings.

  • Open Directory-stored user settings take priority over managed device-applied device profiles.

  • Managed device-applied device profiles take priority over Open Directory-stored computer settings.

  • Manually installed user and device profiles always have the lowest priority over Open Directory-stored or managed device-applied user or device settings.