> ## Documentation Index
> Fetch the complete documentation index at: https://orgo.space/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Branding

> Your logos and login screen — make the platform look like yours.

Branding is the first thing your members see. A custom logo and login background turn a generic platform into *your* platform. Upload logos for both light and dark themes, and set a branded login screen.

**Settings → Organization → Branding**

<img src="https://mintcdn.com/orgo-dc7abe63/cmshtb5BOtVAsAaF/images/platform/organisation/branding-logo-grid.png?fit=max&auto=format&n=cmshtb5BOtVAsAaF&q=85&s=979c3c4b53baace405633a133c7d69b1" alt="Branding page with logo upload areas" style={{ width: "100%", borderRadius: "8px", border: "1px solid var(--border-color)", marginBottom: "1rem" }} width="1840" height="960" data-path="images/platform/organisation/branding-logo-grid.png" />

<Note>
  Requires **Tenant Admin** permissions.
</Note>

***

## Setting up your brand

<Steps>
  <Step title="Open the Branding page">
    Go to **Settings → Organization → Branding**. You'll see a 2×2 grid of logo upload areas and a login background section below.
  </Step>

  <Step title="Upload your logos">
    Upload all four logo variants (see details below). Click each upload area or drag and drop your image files. Use PNG with transparent background for best results.
  </Step>

  <Step title="Set the login background">
    Scroll down to the **Auth Background** section. Paste a publicly accessible HTTPS URL for the image you want behind your login, registration, and password reset screens.
  </Step>

  <Step title="Save">
    Click **Save**. Logos update immediately across the platform. The login background appears on the next page load.
  </Step>
</Steps>

***

## Logos

Upload four logo variants so your brand looks sharp everywhere:

<CardGroup cols={2}>
  <Card title="Logo light theme" icon="sun">
    Your main logo for sidebar, headers, and emails on light backgrounds. Use a horizontal PNG with transparent background.
  </Card>

  <Card title="Logo dark theme" icon="moon">
    A lighter version that pops on dark backgrounds. Same spots as the light logo, but in dark mode.
  </Card>

  <Card title="Squared logo" icon="square">
    Square crop for the collapsed sidebar, mobile app icon, and browser favicon.
  </Card>

  <Card title="Icon logo dark" icon="circle-half-stroke">
    Square crop for compact displays in dark mode.
  </Card>
</CardGroup>

| Logo slot       | Recommended size | Aspect ratio | Where it's used                                 |
| --------------- | ---------------- | ------------ | ----------------------------------------------- |
| **Light theme** | 400×100px+       | Horizontal   | Sidebar (expanded), email headers, public pages |
| **Dark theme**  | 400×100px+       | Horizontal   | Same spots in dark mode                         |
| **Squared**     | 200×200px+       | 1:1 (square) | Collapsed sidebar, mobile app, favicon          |
| **Icon dark**   | 200×200px+       | 1:1 (square) | Same compact spots in dark mode                 |

<Tip>
  PNG with transparent background works best for all four slots. It keeps logos clean on both light and dark themes without white rectangles around them.
</Tip>

***

## Login background

<img src="https://mintcdn.com/orgo-dc7abe63/cmshtb5BOtVAsAaF/images/platform/organisation/branding-auth-background.png?fit=max&auto=format&n=cmshtb5BOtVAsAaF&q=85&s=38a7c5a741abb6e65c3a1c5af1f5956e" alt="Auth background image URL field" width="1400" height="260" data-path="images/platform/organisation/branding-auth-background.png" />

Paste a URL for the image you want behind your login, registration, and password reset screens. Use something that represents your organization — a team photo, an event shot, a branded graphic.

The result:

<img src="https://mintcdn.com/orgo-dc7abe63/cmshtb5BOtVAsAaF/images/platform/organisation/branding-login-page.png?fit=max&auto=format&n=cmshtb5BOtVAsAaF&q=85&s=ea3fe01ace80c863e1e1f43c21940445" alt="Branded login page with custom background and logo" width="3840" height="2160" data-path="images/platform/organisation/branding-login-page.png" />

<Tip>
  Aim for at least **1920×1080px** resolution so the image looks sharp on large monitors. The image URL must be publicly accessible over HTTPS — images behind a login or private CDN won't load.
</Tip>

***

## Real-world example

> **Scenario**: A youth sports federation rebranding their Orgo instance.

1. **Light logo**: Horizontal federation logo (blue text on transparent background) — appears in the sidebar and all member emails.
2. **Dark logo**: White version of the same logo — used when members switch to dark mode.
3. **Squared logo**: The federation's shield/crest icon only — appears in the collapsed sidebar and as the mobile app icon.
4. **Icon dark**: White version of the shield — for dark mode compact displays.
5. **Login background**: A wide-angle photo from their national championship event — makes the login page feel like arriving at a federation event.

Result: Members see the federation's brand at every touchpoint — login, sidebar, emails, and mobile. Dark mode users see properly contrasted versions instead of invisible logos.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Logo looks cropped or stretched">
    Use PNG with transparent background. Main logos should be horizontal (wide, not tall). Squared/icon logos should be perfectly square (1:1 ratio). Avoid excessive padding around the logo in the file itself — the platform adds its own spacing.
  </Accordion>

  <Accordion title="Background image isn't showing on the login page">
    Confirm the URL is publicly accessible over HTTPS. Try opening the URL directly in an incognito browser window. If it loads there, the issue is browser cache — clear cache or wait. If it doesn't load, the image hosting may require authentication.
  </Accordion>

  <Accordion title="Dark theme logo isn't appearing">
    Check you uploaded to the right slot — **Logo dark theme** (top-right in the grid) for the full horizontal logo, **Icon logo dark** (bottom-right) for the square version. Each slot serves a different purpose.
  </Accordion>

  <Accordion title="Logo appears with a white background instead of transparent">
    Your image file is likely JPEG (which doesn't support transparency) or a PNG that was exported with a white background. Re-export from your design tool as PNG with transparency enabled. In Figma: export as PNG, check "transparent background". In Photoshop: Save as PNG, don't flatten layers.
  </Accordion>
</AccordionGroup>

***

## Related

* [Organization Info](/platform/organisation/organisation-info) — Name, contact, and financial details
* [Modules](/platform/organisation/modules) — Enable/disable platform features
* [Labels & Terminology](/platform/customization/labels) — Rename default terms to match your brand language