Setting the Finder Sidebar Icon

Overview

To set the sidebar icon for your File Provider extension, set the CFBundleSymbolName key in the File Provider extension’s Info.plist file. The key takes the name of one of the SF Symbols. For the complete list of available symbols, see SF Symbols 3.

This image shows setting the sidebar icon to the cloud.bolt.fill symbol in the Plist editor.

[Image]

Alternatively, you can open the Info.plist file as source code and edit the XML directly.

<?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>CFBundleIcons</key>
    <dict>
        <key>CFBundlePrimaryIcon</key>
        <dict>
            <key>CFBundleSymbolName</key>
            <string>cloud.bolt.fill</string>
        </dict>
    </dict>
    <key>NSExtension</key>
    <dict>
        <key>NSExtensionFileProviderDocumentGroup</key>
        <string>group.com.examples.My-File-Provider-App</string>
        <key>NSExtensionFileProviderSupportsEnumeration</key>
        <true/>
        <key>NSExtensionPointIdentifier</key>
        <string>com.apple.fileprovider-nonui</string>
        <key>NSExtensionPrincipalClass</key>
        <string>$(PRODUCT_MODULE_NAME).FileProviderExtension</string>
    </dict>
</dict>
</plist>

To create a custom symbol for your app, see Creating custom symbol images for your app. To see a sample code project that uses a custom symbol, see Synchronizing files using file provider extensions.

See Also

Essentials

• Synchronizing the File Provider Extension
• Synchronizing files using file provider extensions