<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Declarations",
  "metadataVersion" : "0.1.0",
  "role" : "Device Management Profile",
  "symbol" : {
    "kind" : "Device Management Profile",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "mdm-profiles:Declarations"
  },
  "title" : "Declarations"
}
-->

# Declarations

The payload that applies a set of declarations to the device through the Settings app.

```
object Declarations
```

## Discussion

Specify `com.apple.declarations` as the payload type.

This profile applies a set of declarations to the device. Users use this profile to install declarations without requiring an MDM enrollment. A device management server can’t install a configuration profile containing this payload type. Device management servers need to use declarative device management to install declarations.

> Important:
> When a user installs the profile, the device only applies configuration declarations that allow a “local” enrollment. Consult the documentation for each configuration type to see if you can use it.

### Profile availability

|||
|--------------------------|-----------------------------------|
|Device channel            |iOS, macOS, tvOS, visionOS, watchOS|
|User channel              |macOS                              |
|Allow manual install      |iOS, macOS, tvOS, visionOS, watchOS|
|Requires supervision      |N/A                                |
|Requires user-approved MDM|N/A                                |
|Allowed in user enrollment|N/A                                |
|Allow multiple payloads   |iOS, macOS, tvOS, visionOS, watchOS|

### Profile example

```plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>PayloadContent</key>
    <array>
        <dict>
            <key>Declarations</key>
            <array>
                <data>
                ewogICJUeXBlIjogImNvbS5hcHBsZS5hY3RpdmF0aW9u
                LnNpbXBsZSIsCiAgIklkZW50aWZpZXIiOiAiMzJGOUVF
                RkMtQzM5QS00QjI5LUJCRjgtNUM5Q0RBQTIyMDU3IiwK
                ICAiU2VydmVyVG9rZW4iOiAiODhFMjUzQjctNzYyNC00
                QUNGLTg1NTEtMzA4RDgyMUM0Njg0IiwKICAiUGF5bG9h
                ZCI6IHsKICAgICJTdGFuZGFyZENvbmZpZ3VyYXRpb25z
                IjogWwogICAgICAiMDdBMUUxNDgtMkM2Ri00Mzk0LTk4
                RTctNzRFMjA1RTAxQjIwIgogICAgXQogIH0KfQo=
                </data>
                <data>
                ewogICJUeXBlIjogImNvbS5hcHBsZS5jb25maWd1cmF0
                aW9uLm1hbmFnZW1lbnQudGVzdCIsCiAgIklkZW50aWZp
                ZXIiOiAiMDdBMUUxNDgtMkM2Ri00Mzk0LTk4RTctNzRF
                MjA1RTAxQjIwIiwKICAiU2VydmVyVG9rZW4iOiAiRUIy
                N0U5RjctRkZGQi00MUJFLTk4MEMtRThBNUZCODAxMzky
                IiwKICAiUGF5bG9hZCI6IHsKICAgICJFY2hvIjogIkVj
                aG8gdGhpcyBtZXNzYWdlIiwKICAgICJSZXR1cm5TdGF0
                dXMiOiAiSW5zdGFsbGVkIgogIH0KfQo=
                </data>
            </array>
            <key>PayloadDescription</key>
            <string>Configures a set of declarations</string>
            <key>PayloadDisplayName</key>
            <string>Declarations profile</string>
            <key>PayloadIdentifier</key>
            <string>com.apple.declarations.2a3f8721-352d-48c0-a83d-737dc64589ad</string>
            <key>PayloadType</key>
            <string>com.apple.declarations</string>
            <key>PayloadUUID</key>
            <string>5edd1fa1-31ce-43ee-a6dc-8e0bed5e9c20</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
        </dict>
    </array>
    <key>PayloadDisplayName</key>
    <string>Test Declaration</string>
    <key>PayloadIdentifier</key>
    <string>declarations-5959abc0-1135-4d22-8ff0-a170bcceb3c8</string>
    <key>PayloadRemovalDisallowed</key>
    <false/>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>5959abc0-1135-4d22-8ff0-a170bcceb3c8</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
</dict>
</plist>
```

---

Copyright &copy; 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)