Updated today Sherlog

Home Screen Layout

com.apple.homescreenlayout

The payload that configures the Home Screen layout.

iOS 9.3+tvOS 11.0+

Requires supervision on iOS, tvOS · Only one instance per profile

Configuration Keys (2)

Key	Type	Title	Description	Default	Range
`Dock` An array of dictionaries, each of which must conform to the icon dictionary format. If this key isn't present, the user's Dock is empty.	array	—	An array of dictionaries, each of which must conform to the icon dictionary format. If this key isn't present, the user's Dock is empty.	—	—
`Pages`required An array of arrays of dictionaries, each of which must conform to the icon dictionary format.	array	—	An array of arrays of dictionaries, each of which must conform to the icon dictionary format.	—	—
`IconItem` An array of dictionaries that conform to the icon dictionary format.	dict	—	An array of dictionaries that conform to the icon dictionary format.	—	—
`Type`required The type of the Dock item. Range: Application, Folder, WebClip	string	—	The type of the Dock item.	—
`DisplayName` The human-readable string shown to the user. This setting is valid only if the type is `Folder`.	string	—	The human-readable string shown to the user. This setting is valid only if the type is `Folder`.	—	—
`BundleID` The bundle identifier of the app. The device requires this setting if the type is `Application`.	string	—	The bundle identifier of the app. The device requires this setting if the type is `Application`.	—	—
`Pages` An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`.	array	—	An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`.	—	—
`URL` iOS 11.3+ The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined. Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip.	string	—	The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined. Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip.	—	—
`PagesItem`	array	—	—	—	—
`IconItem` An array of dictionaries that conform to the icon dictionary format.	dict	—	An array of dictionaries that conform to the icon dictionary format.	—	—
`PagesItem`	array	—	—	—	—
`IconItem` An array of dictionaries that conform to the icon dictionary format.	dict	—	An array of dictionaries that conform to the icon dictionary format.	—	—
`Type`required The type of the Dock item. Range: Application, Folder, WebClip	string	—	The type of the Dock item.	—
`DisplayName` The human-readable string shown to the user. This setting is valid only if the type is `Folder`.	string	—	The human-readable string shown to the user. This setting is valid only if the type is `Folder`.	—	—
`BundleID` The bundle identifier of the app. The device requires this setting if the type is `Application`.	string	—	The bundle identifier of the app. The device requires this setting if the type is `Application`.	—	—
`Pages` An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`.	array	—	An array of arrays of dictionaries, each conforming to the icon dictionary format. This setting is valid only if the type is `Folder`.	—	—
`URL` iOS 11.3+ The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined. Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip.	string	—	The URL of the existing web clip for this item. The device requires this setting if `type` is `WebClip`. If more than one web clip exists with the same URL, the behavior is undefined. Specifying a web clip in this payload doesn't create the web clip. Use the `WebClip` payload to create a web clip.	—	—
`PagesItem`	array	—	—	—	—