<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 18.4.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/SoftwareUpdateSettings",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rmdm-declarations:SoftwareUpdateSettings"
  },
  "title" : "SoftwareUpdateSettings"
}
-->

# SoftwareUpdateSettings

The declaration to configure software updates.

```
object SoftwareUpdateSettings
```

## Discussion

Specify `com.apple.configuration.softwareupdate.settings` as the declaration type.

### Configuration availability

|||
|--------------------------------|------------------------------------------------------------------------------------|
|Allowed in supervised enrollment|iOS, macOS, Shared iPad, tvOS, visionOS                                             |
|Allowed in device enrollment    |iOS, Shared iPad, tvOS, visionOS                                                    |
|Allowed in user enrollment      |N/A                                                                                 |
|Allowed in local enrollment     |N/A                                                                                 |
|Allowed in system scope         |iOS, macOS, Shared iPad, tvOS, visionOS                                             |
|Allowed in user scope           |N/A                                                                                 |
|Apply                           |Multiple configurations are combined and applied as a single effective configuration|

### Configuration example

This configuration manages software update behavior and deferral settings.

```json
{
    "Type": "com.apple.configuration.softwareupdate.settings",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "Notifications": false,
        "Deferrals": {
            "MajorPeriodInDays": 30
        },
        "RecommendedCadence": "All",
        "AutomaticActions": {
            "Download": "AlwaysOn",
            "InstallOSUpdates": "AlwaysOn",
            "InstallSecurityUpdate": "AlwaysOn"
        },
        "RapidSecurityResponse": {
            "Enable": false
        },
        "AllowStandardUserOSUpdates": false,
        "Beta": {
            "ProgramEnrollment": "AlwaysOn"
        }
    }
}
```

## Topics

### Objects

[`SoftwareUpdateSettingsAutomaticActionsObject`](/documentation/DeviceManagement/SoftwareUpdateSettingsAutomaticActionsObject)

This object configures various automatic Software Update functionality.

[`SoftwareUpdateSettingsBetaObject`](/documentation/DeviceManagement/SoftwareUpdateSettingsBetaObject)

This object configures the beta program settings for a device.

[`SoftwareUpdateSettingsDeferralsObject`](/documentation/DeviceManagement/SoftwareUpdateSettingsDeferralsObject)

This object configures the deferral of software updates. Background Security Improvements aren’t considered in `Major`, `Minor`, or `System` deferral mechanism.

[`SoftwareUpdateSettingsRapidSecurityResponseObject`](/documentation/DeviceManagement/SoftwareUpdateSettingsRapidSecurityResponseObject)

These configurations set user access to interacting with Background Security Improvement.


---

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)