Logo Dimensions

This guide explains the dimension requirements for raster image logos (PNG, JPG, GIF).

Note: SVG files are not subject to dimension validation because they scale perfectly at any size.

Default Dimension Limits

Dimension	Minimum	Maximum
Width	50px	300px
Height	30px	100px

Customizing Limits

You can customize the dimension limits in appsettings.json:

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

Recommended Dimensions

For best results in the navigation bar:

Width: 120-180 pixels
Height: 40-60 pixels
Aspect ratio: Approximately 3:1 or 4:1

Common Errors

BRANDING_LOGO_TOO_SMALL

The logo dimensions are below the minimum. Solutions:

Use a higher resolution version of your logo
Reduce the minimum dimension settings
Switch to SVG format (no dimension validation)

BRANDING_LOGO_TOO_LARGE

The logo dimensions exceed the maximum. Solutions:

Resize your logo to fit within the limits
Increase the maximum dimension settings
Switch to SVG format (no dimension validation)

Resizing Your Logo

If you need to resize your logo, you can use:

Image editing software (Photoshop, GIMP, Paint.NET)
Online tools (Canva, Pixlr)
Command-line tools (ImageMagick)

Tip: When resizing, maintain the aspect ratio to avoid distortion. Most image editors have a "constrain proportions" or "lock aspect ratio" option.