App Catalog
What's NewStatusRoot3
  • 🌟Introduction to App Catalog
  • πŸš€Getting Started
  • πŸ—οΈComponents
  • πŸ”’Security & Privacy
  • βœ…Requirements
  • πŸ› οΈConfiguration & Deployment
    • Configuration Profile
      • Preference Keys - Catalog Agent
      • Preference Keys - Catalog App
      • Integrating with MDM
      • Configuration Profile Example
    • Installing App Catalog
    • Granting User Notifications
    • Managed Login Item
    • Full Disk Access (PPPC)
  • πŸ•ΉοΈCatalog Agent
    • Catalog Agent CLI
    • Installing apps
      • Dock items
      • Mandatory Apps
      • Force reinstalling apps
    • Updating apps
      • User deferrals
      • Delaying app updates
      • Updating individual apps
  • πŸ–₯️Catalog App
    • Application modes
    • User Mode
    • Admin Mode
    • Branding
      • App and notification icon
      • In-app branding
    • Language
    • Updating apps
  • πŸ”ŒIntegration Guides
    • Microsoft Intune
    • Jamf Pro
    • Kandji
    • Root3 Support App
  • Troubleshooting
    • Logging
    • Error codes
    • Uninstalling App Catalog
  • ❓How To's
    • Get an app Bundle Identifier
    • Get an SF Symbol
    • Get TeamViewer Configuration ID
Powered by GitBook
On this page
  • URL or File
  • Design
  • Deployment behaviour and mutations

Was this helpful?

  1. Catalog App
  2. Branding

App and notification icon

PreviousBrandingNextIn-app branding

Last updated 4 months ago

Was this helpful?

The key CustomAppIcon controls the app and notification icon with a custom image. This includes the app icon in the Dock and the main icon in update notifications.

URL or File

When using an image from URL or local file image, there are no special requirements other than the full path to the image.

Design

Our vision is to adopt macOS platform designs as closely as possible. Users should have a fantastic experience, while administrators should find it effortless to apply a custom icon. App Catalog automatically resizes the image with the appropriate padding and applies rounded corners to comply with Non-square images retain their aspect ratio. The result is an icon that seamlessly integrates with other macOS icons.

Deployment behaviour and mutations

When CustomAppIcon is set, the branding will be applied directly after installing App Catalog. If the CustomAppIcon is set when App Catalog was already installed, it takes up to an hour to be applied.

In case you would like to replace a custom icon, you need to specify a different URL for CustomAppIcon in the Configuration Profile. If an image from a remote URL was changed but the URL itself stays the same, it is suggested to append a query string with the version number. This will tell the App Catalog to reload the image and apply the new version to the app and notification (also takes up to an hour). For example:

  • Old URL: https://URL/TO/IMAGE

  • New URL: https://URL/TO/IMAGE?v1

Alternatively the following command will always cause a reload of the branding without changing CustomAppIcon:

% sudo catalog --set-app-icon

If the Catalog App is already added to the Dock, the branding in the Dock icon will be visible after a restart/login or when the app is opened by the user.

πŸ–₯️
Apple’s Human Interface Guidelines.
Source Image
Result in Dock