# HomeScreenLayout The payload that configures the Home Screen layout. ``` object HomeScreenLayout ``` ## Discussion Specify `com.apple.homescreenlayout` as the payload type. This payload defines a layout of apps, folders, and web clips for the Home Screen. This layout is locked and can’t be modified by the user. If a Home Screen layout puts more than four items in the iPhone Dock the location of the fifth and succeeding items may be undefined but they will not be omitted. To disable deletion of apps, set `allowAppRemoval` to `false` with [`Restrictions`](/documentation/DeviceManagement/Restrictions). ### Profile availability ||| |--------------------------|----------------------| |Device channel |iOS, Shared iPad, tvOS| |User channel |Shared iPad | |Allow manual install |iOS, tvOS | |Requires supervision |iOS, tvOS | |Requires user-approved MDM|N/A | |Allowed in user enrollment|N/A | |Allow multiple payloads |N/A | ### Profile example ```plist PayloadContent Dock Type Application BundleID com.apple.mobilesafari Type Application BundleID com.apple.Preferences Type Folder DisplayName Example Pages Type WebClip DisplayName Example URL companyname.com Type Application BundleID com.apple.News Pages Type Application BundleID com.apple.MobileSMS Type Application BundleID com.apple.camera Type Folder DisplayName Display Name exampler Pages Type Application BundleID com.apple.podcasts Type WebClip URL https://www.apple.com DisplayName Custom Home Screen Layout Type Application BundleID com.apple.AppStore Type Folder DisplayName Important Folder Type Application BundleID com.apple.Bridge PayloadIdentifier com.example.myhomescreenlayoutpayload PayloadType com.apple.homescreenlayout PayloadUUID f0b2d13e-a985-4264-9901-707feabddfcd PayloadVersion 1 PayloadDisplayName Home Screen Layout PayloadIdentifier com.example.myprofile PayloadType Configuration PayloadUUID 24c41ae0-f8a9-4d9f-a007-d67b0dc15af4 PayloadVersion 1 ``` ## Topics ### Objects [`HomeScreenLayout.IconItem`](/documentation/DeviceManagement/HomeScreenLayout/IconItem) An array of dictionaries that conform to the icon dictionary format. --- 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)