Set global brand defaults for Kinde hosted authentication pages

Authentication actions such as sign-up, sign-in, and password reset happen on Kinde-hosted pages. Set your brand defaults so your users never feel like they left your product.

Changes apply immediately to your apps. You do not need to redeploy your application code.

To set global brand defaults:

1. Sign in to your Kinde dashboard and select Design.
2. Go to Global > Brand.

Upload brand assets

Link to this section

Logo

Link to this section

Add your company logo to authentication pages. You can upload logos for both light and dark mode.

• Maximum logo size: 1MB
• Supported file types: SVG, PNG, JPG, WebP, and AVIF

After uploading, select Save to apply your changes. The logo is immediately visible on the sign-in page. You do not need to redeploy your application.

Kinde default:

After custom logo upload:

Logos are resized to a maximum width or height of 120 pixels based on aspect ratio. SVG works best because it displays well on any screen, but PNG and other formats are accepted.

120px is the maximum logo height or width

The 120 px maximum height or width is a fixed constraint and cannot be changed through standard brand settings. If you need a larger logo, use custom authentication pages to control the layout and sizing directly.

Make the logo clickable

Link to this section

1. Go to the Kinde dashboard > Settings > Environment > Applications.

2. Select View details on your target application tile.

3. Scroll down to the Callback URLs section.

4. Enter the destination URL in the Application homepage URI field (e.g., https://app.yourbusiness.com or https://yourbusiness.com).

   

   Repeat for every application whose logo link you want to update.

If you are using third-party tracking, the URL will also reflect that the user clicked out of the sign-up/sign-in screen, so you can distinguish this action from successful sign-ins.

Favicon

Link to this section

Favicons are small icons that appear on browser tabs and mobile app shortcuts.

• Maximum favicon size: 5KB
• Primary file type: SVG
• Fallback file type: PNG
• Must be a multiple of 48px (e.g., 48x48, 96x96, 144x144, etc.)

1. In the Favicon section:
   1. Add an SVG favicon (so it works in most browsers).
   2. Add a Fallback PNG for other browsers, such as Safari.
2. Select Save.

Kinde default:

Custom:

If you want to use your own domain on the auth pages instead of the default yourbusiness.kinde.com, configure a custom domain.

Avatar

Link to this section

The custom avatar is used on various Kinde UI pages for a consistent brand experience.

• Maximum avatar size: 5KB
• Supported file type: SVG
• Display resolution: 36px square

1. In the Avatar section, select Upload image.
2. Select Save.

The avatar appears in the bottom left of the Kinde interface, next to your business name.

Kinde default:

Custom:

Theme (light or dark mode)

Link to this section

Set the default theme to match your application preference:

• Light: white background with dark text
• Dark: dark background with light text
• User preference: the theme is determined by the user’s device preference

When using User preference, configure brand colors for both light and dark modes.

Select Save to apply your changes.

Other page elements

Link to this section

• Pages: Set the background color of auth pages in light and dark modes.
• Cards: Set the border radius for card elements in pixels. (Default is 16px)
• Buttons: Customize buttons for light and dark mode. You can change:
  • Background color
  • Text color
  • Border radius (default is 8px)
• Input fields: Set the border radius for input fields in pixels. (Default is 8px)
• Links: Set the link text color in light and dark mode.

Global logo fallback behavior

Link to this section

If you use organizations, each organization can have its own logo. When an organization has no logo, this setting controls what appears on auth pages instead.

Setting	Logo display order
Enabled	Organization logo → global logo → organization name
Disabled	Organization logo → organization name → global logo

Enable this when organizations should fall back to your business brand before showing a text name. Disable it when you prefer the organization name before the global logo.

1. On the Global > Brand page, scroll to Global logo fallback.

   

2. Turn the setting on or off.

3. Select Save.

To upload logos per organization, see Set unique branding for an organization.

Manage global logo via the Kinde Management API

Link to this section

Requires an M2M access token with the update:environments scope. See get an access token for the Kinde Management API.

Add logo

Link to this section

curl --request PUT \
  --url '<YOUR_DOMAIN>/api/v1/environment/logos/<TYPE>' \
  --header 'Authorization: Bearer <M2M_ACCESS_TOKEN>' \
  --form 'logo=@/path/to/logo.png'

Replace <YOUR_DOMAIN> with either your custom domain (e.g. https://auth.yourbusiness.com) or your Kinde subdomain (e.g. https://yourbusiness.kinde.com).

• For different logo variations, set <TYPE> to light or dark.
• Use the logo form field to upload a supported file type smaller than 1MB (SVG, PNG, JPG, WebP, or AVIF). Curl sets the multipart boundary automatically when you use --form.

Delete logo

Link to this section

curl --request DELETE \
  --url '<YOUR_DOMAIN>/api/v1/environment/logos/<TYPE>' \
  --header 'Authorization: Bearer <M2M_ACCESS_TOKEN>'

See the Kinde Management API documentation for more details.

Next steps

Link to this section

Brand defaults cover logos, colors, and core page elements. For fuller control of the authentication experience:

• Custom design with code — style hosted auth pages with your own CSS and HTML.
• Custom sign-up and sign-in pages — build and host your own authentication pages when you need complete layout control.