In-app branding

Logo

The keys Logo and LogoDark control the logo shown in the sidebar and in other places of the Catalog App.

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.

SF Symbol

To apply an SF Symbol, the use the SF= prefix, followed by the SF Symbol name:

Example
XML
Copy
<key>Logo</key>
<string>SF=building.2.crop.circle.fill</string>

Color options:

To apply a color rendering mode or custom color, some color options are available:

• auto: the macOS Accent Color or the color set by CustomColor

Example
XML
Copy
<key>Logo</key>
<string>SF=building.2.crop.circle.fill,color=auto</string>

• multicolor: Enables the multicolor rendering mode

Example
XML
Copy
<key>Logo</key>
<string>SF=app.badge.fill,color=multicolor</string>

• hierarchical: Enabled the hierarchical rendering mode

Example
XML
Copy
<key>Logo</key> <string>SF=building.2.crop.circle.fill,color=hierarchical</string>

• HEX color code: Apply a custom color and overrule if CustomColor is set. Set the color using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F)

Example
XML
Copy
<key>Logo</key>
<string>SF=building.2.crop.circle.fill,color=#9ACEA4</string>

• Default: Enables the monochrome rendering mode

Example
XML
Copy
<key>Logo</key>
<string>SF=building.2.crop.circle.fill</string>

Sidebar titles

The sidebar allows setting a title and subtitle to provide additional context to the user. Both titles are optional and appear at the top of the sidebar or, if a logo is set, directly beneath the logo.

Example
XML
Copy
<key>SidebarTitle</key>
<string>Sidebar Title</string>
<key>SidebarSubtitle</key>
<string>Sidebar Subtitle</string>

Color

Set a custom color to use across the app instead of the macOS accent color. For example, sidebar icons and the install buttons will be use this color. Set the color using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F).

Example
XML
Copy
<key>CustomColor</key>
<string>#9ACEA4</string>

Header

Catalog App can be branded with an optional header image or color which is presented above the available apps and updates. This key accepts a remote image from URL or one or more colors which result into a gradient effect. The header option is exclusive to macOS 26 and uses Apple’s new background extension effect which shows the image edge to edge and mirrors under the sidebar to avoid losing content.

To use the color option, start the string with "color=" followed by the color(s) using the HEX code in RGB format, a '#' immediately followed by six hexadecimal characters(0-9, A-F). Use a comma as separator when using multiple colors.

Availability: macOS 26+

Example
XML
Copy
<key>Header</key>
<string>/PATH/TO/URL</string>

Example
XML
Copy
<key>Header</key>
<string>color=#9ACEA4,#7FCBD7,#F39B9C</string>

Image option

Color option