BlackMountain allows you to customize your organization's appearance with custom branding. Upload logos and icons for both light and dark modes to create a consistent visual experience for your team. This article explains how to set up and manage your organization's branding.
What is Custom Branding?
Custom branding in BlackMountain allows you to:
Upload organization logos that appear in the header
Upload organization icons for the collapsed sidebar
Support both light mode and dark mode with separate assets
Create a consistent visual identity across your organization
Who can access branding settings:
Only Owners and Managers can upload and manage branding assets
Viewers cannot access branding settings
Accessing Branding Settings
Navigate to your organization's branding settings:
Go to Settings → Organizations
Select your organization
Click on the Branding tab
Organization Logo
Your organization logo appears in the header when this organization is selected. You can upload separate logos for light and dark modes to ensure optimal visibility.
Upload Requirements
Supported formats: PNG, JPG, SVG, WebP
Maximum file size: 2MB
Recommended dimensions: 200px height, width proportional
Best practice: Use transparent backgrounds (PNG or SVG) for seamless integration
How to Upload Organization Logo
For Light Mode:
Navigate to Settings → Organizations → [Your Organization] → Branding
Under Organization Logo → Light Mode, click Upload light logo
Select your logo file from your computer
The logo will be uploaded and displayed immediately
For Dark Mode:
In the same Branding tab, under Organization Logo → Dark Mode, click Upload dark logo
Select your dark mode logo file
The logo will be uploaded and displayed immediately
Tip: Use high-contrast logos for each mode. For light mode, use a dark logo. For dark mode, use a light logo.
Organization Icon
Your organization icon appears in the sidebar navigation when the sidebar is collapsed. This provides quick visual identification when switching between organizations.
Upload Requirements
Supported formats: PNG, JPG, SVG, WebP
Maximum file size: 2MB
Recommended dimensions: Square format (e.g., 64x64px, 128x128px, 256x256px)
Best practice: Use simple, recognizable icons that work well at small sizes
How to Upload Organization Icon
For Light Mode:
Navigate to Settings → Organizations → [Your Organization] → Branding
Under Organization Icon → Light Mode, click Upload
Select your square icon file
The icon will be uploaded and displayed in the sidebar
For Dark Mode:
In the same Branding tab, under Organization Icon → Dark Mode, click Upload
Select your dark mode icon file
The icon will be uploaded and displayed in the sidebar
Tip: Test your icon at small sizes (32x32px) to ensure it remains recognizable when the sidebar is collapsed.
Light Mode vs. Dark Mode
Light Mode Assets:
Use dark or colored logos on light backgrounds
Ensure sufficient contrast (minimum 4.5:1 ratio)
Test against white or light gray backgrounds
Dark Mode Assets:
Use light or colored logos on dark backgrounds
Ensure visibility against dark gray or black backgrounds
Avoid pure white (use off-white or light gray for softer appearance)
Example:
Light mode logo: Dark blue or black logo
Dark mode logo: White or light blue logo
File Format Recommendations
Format | Best For | Advantages | Disadvantages |
SVG | Logos, icons | Scalable, small file size, sharp at any resolution | Not supported by all image editors |
PNG | Logos with transparency | Supports transparency, widely supported | Larger file size than SVG |
JPG | Photos, complex graphics | Small file size | No transparency, lossy compression |
WebP | Modern browsers | Small file size, supports transparency | Limited support in older browsers |
Recommendation: Use SVG for logos and icons whenever possible. Use PNG with transparency as a fallback.
Managing Branding Assets
Updating Logos or Icons
To update an existing logo or icon:
Navigate to Settings → Organizations → [Your Organization] → Branding
Click the Upload button for the asset you want to replace
Select the new file
The old asset will be automatically replaced
Note: Changes take effect immediately across the entire organization.
Removing Branding Assets
To remove a logo or icon:
Navigate to Settings → Organizations → [Your Organization] → Branding
Hover over the uploaded asset
Click the Remove or Delete icon (if available)
Confirm the removal
Note: If no custom branding is set, BlackMountain will display default branding.
Troubleshooting
Logo Not Displaying
If your logo doesn't appear after uploading:
Check file size: Ensure the file is under 2MB
Check file format: Use PNG, JPG, SVG, or WebP
Clear cache: Refresh the page (Ctrl+F5 or Cmd+Shift+R)
Check permissions: Ensure you have Owner or Manager role
Logo Appears Blurry
If your logo appears blurry:
Use vector format: Upload an SVG file for crisp rendering at all sizes
Increase resolution: Use a higher resolution PNG (2x or 3x the display size)
Check original file: Ensure the source file is high quality
Icon Too Small or Too Large
If your icon doesn't display correctly:
Use square format: Ensure the icon is perfectly square (same width and height)
Check dimensions: Use at least 128x128px for best results
Simplify design: Remove fine details that won't be visible at small sizes
Branding Across the Platform
Your custom branding appears in the following locations:
Organization Logo:
Header bar (when the organization is active)
Organization selector dropdown
Login screen (for organization-specific login pages)
Organization Icon:
Collapsed sidebar navigation
Organization switcher
Mobile app navigation