Branding

Account members with admin or owner roles can set branding for an account under the Settings > Branding page in the Knock dashboard. From here, you can set the logo, icon, primary color, and primary contrast color.

It's also possible to set any number of custom branding properties as key-value pairs by clicking the "Add variable" button, or by using the bulk editor to set multiple variables at once.

Any branding variables you set will be available under the vars.branding.* namespace in your templates, layouts, and HTML partials.

Property	Description
vars.branding.logo_url	The URL of the logo to use for your brand.
vars.branding.icon_url	The URL of the icon to use for your brand.
vars.branding.primary_color	The primary color to use for your brand.
vars.branding.primary_color_contrast	The primary contrast color to use for your brand.

Knock supports setting custom branding for each tenant, via the dashboard or programmatically via the API. Using per-tenant branding lets you override the account-level branding for all messages sent within the context of that tenant.

Learn more about working with tenants.

Once you've set your branding variables, you can use them within your templates using the vars.branding.* namespace. These variables are available in your templates, layouts, and HTML partials.