title: Setup Assistant
description: The payload that configures Setup Assistant settings.
payload:
  payloadtype: com.apple.SetupAssistant.managed
  supportedOS:
    iOS:
      introduced: '14.0'
      multiple: false
      supervised: true
      allowmanualinstall: true
      sharedipad:
        mode: allowed
        devicechannel: true
        userchannel: false
      userenrollment:
        mode: forbidden
    macOS:
      introduced: '10.12'
      multiple: false
      devicechannel: true
      userchannel: true
      supervised: false
      requiresdep: false
      userapprovedmdm: false
      allowmanualinstall: true
      userenrollment:
        mode: forbidden
    tvOS:
      introduced: n/a
    visionOS:
      introduced: n/a
    watchOS:
      introduced: n/a
  content: On macOS, this payload can specify Setup Assistant options for either the
    system or particular users.
payloadkeys:
- key: SkipCloudSetup
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Apple Account setup pane.
- key: SkipSiriSetup
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Siri setup pane.
- key: SkipPrivacySetup
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: 10.13.4
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Privacy consent pane.
- key: SkipiCloudStorageSetup
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: 10.13.4
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the iCloud Storage pane.
- key: SkipTrueTone
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: 10.13.6
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the True Tone Display pane.
- key: SkipAppearance
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '10.14'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Choose Your Look pane.
- key: SkipTouchIDSetup
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '10.15'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Touch ID setup pane.
- key: SkipScreenTime
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '10.15'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Screen Time pane.
- key: SkipAccessibility
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '11.0'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Accessibility pane.
- key: SkipSetupItems
  supportedOS:
    iOS:
      introduced: '14.0'
    macOS:
      introduced: '15.0'
  type: <array>
  presence: optional
  content: An array of strings that describe the setup items to skip. `SkipKeys` provides
    a list of valid strings and their meanings.
  subkeys:
  - key: SkipSetupItems
    type: <string>
- key: SkipUnlockWithWatch
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '12.0'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If `true`, the system skips the Unlock With Apple Watch pane.
- key: SkipWallpaper
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '14.1'
      deprecated: '15.0'
  type: <boolean>
  presence: optional
  default: false
  content: If 'true', the system skips the Wallpaper selection window.
examples:
- title: Profile example
  files:
  - file: examples/mdm/profiles/com.apple.SetupAssistant.managed/example1.plist