# SystemMigration The payload that configures system migration. ``` object SystemMigration ``` ## Discussion Specify `com.apple.systemmigration` as the payload type. ### Profile availability ||| |--------------------------|-----| |Device channel |macOS| |User channel |N/A | |Allow manual install |macOS| |Requires supervision |N/A | |Requires user-approved MDM|N/A | |Allowed in user enrollment|N/A | |Allow multiple payloads |N/A | ### Profile example ```plist PayloadContent CustomBehavior Context Windows Paths SourcePath C:/Users/Documents TargetPath ~/Users/Documents SourcePathInUserHome TargetPathInUserHome PayloadIdentifier com.example.mysystemmigrationpayload PayloadType com.apple.systemmigration PayloadUUID 553d6db9-2704-4127-8384-003926e5b813 PayloadVersion 1 PayloadDisplayName System Migration PayloadIdentifier com.example.myprofile PayloadType Configuration PayloadUUID 75157e67-d7ff-44ec-9ccf-8496be33864a PayloadVersion 1 ``` ## Topics ### Objects [`SystemMigration.CustomBehaviorItem`](/documentation/DeviceManagement/SystemMigration/CustomBehaviorItem) The custom behavior dictionary. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)