---
title: NSFileProviderItemDecorating
framework: fileprovider
role: symbol
role_heading: Protocol
path: fileprovider/nsfileprovideritemdecorating
---

# NSFileProviderItemDecorating

Support for decorating items.

## Declaration

```swift
protocol NSFileProviderItemDecorating : NSFileProviderItemProtocol
```

## Overview

Overview To adopt this protocol, implement the decorations method for your extension’s NSFileProviderItem and return valid identifiers for the desired decorations. You define decorations in the File Provider extension’s Info.plist file by adding the NSFileProviderDecorations key to the NSExtension dictionary.  <key>NSFileProviderDecorations</key>  <array>    <dict>       <key>Identifier</key>       <string>$(PRODUCT_BUNDLE_IDENTIFIER).hasComments</string>       <key>BadgeImageType</key>       <string>com.someone.item.decoration.unreadCommentIcon</string>       <key>Category</key>       <string>Badge</string>       <key>LocalizedTitle</key>       <dict>          <key>NSStringFormat</key>          <string>%@ unread comments</string>          <key>NSStringFormatValues</key>          <array>             <string>item.userInfo.unreadCommentCount</string>          </array>       </dict>    </dict>  </array> Use the following keys to define the decorations: The Category value must be one of the following:

## Topics

### Providing Decorations

- [decorations](fileprovider/nsfileprovideritemdecorating/decorations.md)

## Relationships

### Inherits From

- [NSFileProviderItemProtocol](fileprovider/nsfileprovideritemprotocol.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Items and metadata

- [NSFileProviderItemFields](fileprovider/nsfileprovideritemfields.md)
- [NSFileProviderItemVersion](fileprovider/nsfileprovideritemversion.md)
- [NSFileProviderRequest](fileprovider/nsfileproviderrequest.md)
- [NSFileProviderItemDecorationIdentifier](fileprovider/nsfileprovideritemdecorationidentifier.md)