Logo Requirements

This guide explains the requirements for configuring your application's logo.

Supported Formats

SVG (Recommended) - Scalable, no dimension restrictions
PNG - Good for logos with transparency
JPG/JPEG - Smaller file size, no transparency
GIF - Basic support

Recommendation: Use SVG format when possible. SVG logos scale perfectly at any size and typically have smaller file sizes than raster images.

Configuration

Configure your logo path in appsettings.json:

{
  "Branding": {
    "LogoPath": "wwwroot/images/logo.svg",
    "LogoMinWidth": 50,
    "LogoMaxWidth": 300,
    "LogoMinHeight": 30,
    "LogoMaxHeight": 100
  }
}

File Location

Place your logo file in one of these locations:

wwwroot/images/logo.svg (default location)
Any path under wwwroot/ that's accessible to the web server

Common Errors

BRANDING_LOGO_NOT_CONFIGURED

The LogoPath setting is missing or empty in appsettings.json. Add the path to your logo file.

BRANDING_LOGO_NOT_FOUND

The logo file doesn't exist at the specified path. Verify:

The file exists at the specified location
The path is relative to the project root (e.g., wwwroot/images/logo.svg)
File name and extension match exactly (case-sensitive on Linux)

BRANDING_LOGO_READ_ERROR

The file exists but couldn't be read. Check: