App and notification icon

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 Apple’s Human Interface Guidelines. Non-square images retain their aspect ratio. The result is an icon that seamlessly integrates with other macOS icons.

Source Image
Result in Dock

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

Last updated

Was this helpful?