<!--
{
  "availability" : [
    "macOS: 10.13.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/NSExtension-Mappings-Command",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:put:mdm#NSExtensionMappingsCommand"
  },
  "title" : "NSExtension Mappings"
}
-->

# NSExtension Mappings

Get a list of the installed extensions for a user on a device.

## Discussion

This list is a superset of the list that [`ActiveNSExtensionsCommand`](/documentation/DeviceManagement/ActiveNSExtensionsCommand) returns. It may contain extensions that the system never enables due to various restrictions.

Refer to the following sections to determine supported channels and requirements, and to see an example request and response.

### Command availability

|||
|--------------------------|------------------|
|Device channel            |N/A               |
|User channel              |macOS             |
|Requires supervision      |macOS             |
|Allowed in user enrollment|N/A               |
|Required access right     |QueryInstalledApps|

### Example request and response

**Request:**

```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>Command</key>
    <dict>
        <key>RequestType</key>
        <string>NSExtensionMappings</string>
    </dict>
    <key>CommandUUID</key>
    <string>0001_NSExtensionMappings</string>
</dict>
</plist>
```

**Response:**

```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>CommandUUID</key>
    <string>0001_NSExtensionMappings</string>
    <key>NSExtensionMappings</key>
    <array>
        <dict>
            <key>DisplayName</key>
            <string>Photos</string>
            <key>ExtensionPoint</key>
            <string>com.apple.storagemanagement</string>
            <key>Identifier</key>
            <string>com.apple.Photos.StorageManagementExtension</string>
        </dict>
        <dict>
            <key>DisplayName</key>
            <string>Messages</string>
            <key>ExtensionPoint</key>
            <string>com.apple.share-services</string>
            <key>Identifier</key>
            <string>com.apple.messages.ShareExtension</string>
        </dict>
        <dict>
            <key>DisplayName</key>
            <string>iCloud Drive</string>
            <key>ExtensionPoint</key>
            <string>com.apple.fileprovider-nonui</string>
            <key>Identifier</key>
            <string>com.apple.CloudDocs.MobileDocumentsFileProvider</string>
        </dict>
        <dict>
            <key>DisplayName</key>
            <string>Notes Spotlight Index Extension</string>
            <key>ExtensionPoint</key>
            <string>com.apple.spotlight.index</string>
            <key>Identifier</key>
            <string>com.apple.Notes.SpotlightIndexExtension</string>
        </dict>
    </array>
    <key>NotOnConsole</key>
    <false/>
    <key>Status</key>
    <string>Acknowledged</string>
    <key>UDID</key>
    <string>E84CD517-CB37-52F7-988C-DB5137B604B8</string>
    <key>UserID</key>
    <string>03EBB586-53E7-48CE-8E6E-C54A374F6FA6</string>
    <key>UserLongName</key>
    <string>admin</string>
    <key>UserShortName</key>
    <string>admin</string>
</dict>
</plist>
```

## Topics

### Commands and responses

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

The command to get a list of the installed extensions for a user on a device.

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

A response from the device after it processes the command to get a list of the installed extensions for a user on a device.



---

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)