Contents

Package

The declaration to configure a package.

Declaration

object Package

Properties

NameTypeDescription
InstallBehaviorPackageInstallBehaviorObject

A dictionary that describes how and when to install the package.

ManifestURL Requiredstring

The URL of the manifest document for the package that the device downloads. The manifest is returned as a ManifestURL property list. The url property of the manifest must point to the package (.pkg) file to install.

UninstallBehaviorPackageUninstallBehaviorObject

A dictionary that describes how to uninstall the package.

Available: macOS 27+

Mentioned in

Discussion

Specify com.apple.configuration.package as the declaration type.

This declaration installs a package on a device. Packages can contain apps, fonts, documents, and other items. Apps that a package installs aren’t automatically managed; you can manage them using the AppManaged declaration.

Configuration availability

Allowed in supervised enrollment

macOS

Allowed in device enrollment

N/A

Allowed in user enrollment

N/A

Allowed in local enrollment

N/A

Allowed in system scope

macOS

Allowed in user scope

N/A

Apply

Multiple configurations are applied separately

Configuration example

This configuration installs a required package.

{
    "Type": "com.apple.configuration.package",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "ManifestURL": "https://example.com/files/packages/TestPackage.plist",
        "InstallBehavior": {
            "Install": "Required"
        }
    }
}

Topics

Objects

See Also

Configurations