Branding
Replace the default product name and logos with your own, so the sign-in screen, sidebar, and outbound emails carry your company's identity. Branding applies to your whole workspace.
:::note Before you begin
- You need an administrator role. The settings page lives in the admin console at
/admin/settings. - Have your assets ready: a company name, a logo for light backgrounds, a logo for dark backgrounds, and a square favicon. Every field is optional — set what you have now and add the rest later. :::
Set your branding
- In the admin console, open Settings, then select the Branding tab.
- In the Company identity card, enter your Company name. This name shows on the sign-in screen, the sidebar, and emails. Leave it blank to keep the default.
- Under Logo (light background), select a file to upload. This logo appears on the sign-in page and white sidebars.
- Under Logo (dark background), select a file. This logo appears on the dark sidebar and the dark-mode header. The preview sits on a dark backdrop so you can check contrast.
- Under Favicon, select a square image. It becomes the browser-tab icon.
- Select Save changes at the bottom of the page.
After you save, the page reloads with a Settings saved confirmation at the top, and each preview tile updates to show the image you uploaded.
The light and dark logos are separate slots. A single logo with dark text reads well on white but disappears on the dark sidebar — upload a light-coloured version to the Logo (dark background) slot so it stays legible in both themes.
Field reference
All four fields live in the Company identity card on the Branding tab. None is required.
| Field | Required | Default | Notes |
|---|---|---|---|
| Company name | No | The platform's configured name | Free text, max 120 characters. Shown on the sign-in screen, sidebar, and emails. |
| Logo (light background) | No | None (placeholder icon) | Shown on the sign-in page and white sidebars. See Image requirements. |
| Logo (dark background) | No | None (placeholder icon) | Shown on the dark sidebar and dark-mode header. Previewed on a dark backdrop. |
| Favicon | No | None | The browser-tab icon. Center-cropped to a square on upload. |
Image requirements
The platform processes each upload on save, so you don't have to match an exact size before uploading.
| Asset | Accepted formats | Max file size | What the platform does on save |
|---|---|---|---|
| Logo (light) | PNG, JPG, SVG, WebP | 2 MB | Resizes to fit a 320×96 box, preserving aspect ratio and transparency. |
| Logo (dark) | PNG, JPG, SVG, WebP | 2 MB | Resizes to fit a 320×96 box, preserving aspect ratio and transparency. |
| Favicon | PNG, ICO, SVG | 512 KB | Center-crops to a square and scales to 64×64. |
SVG uploads are sanitized on save — embedded scripts, event handlers, and external references are stripped before the file is stored. This keeps a logo from carrying active content into pages where it's inlined. The visible artwork is unaffected.
Logos render best as a PNG or SVG with a transparent background, since the same file sits on a white tile and a dark tile in the preview. For the favicon, a 32×32 or larger square image gives the crispest tab icon.
Replace or remove an asset
To swap a logo or favicon, upload a new file in its slot and select Save changes. The old file is deleted and replaced.
To remove an asset entirely:
- On the Branding tab, find the asset's tile. The Remove current logo (or Remove current favicon) checkbox appears only when an asset is already set.
- Select the checkbox.
- Select Save changes. The asset is cleared and the slot falls back to its default — the placeholder icon for a logo, or no custom icon for the favicon.
Removing an asset deletes the stored file. To restore it, upload the image again.
Where branding appears
| Surface | Uses |
|---|---|
| Sign-in screen | Company name and light logo |
| Sidebar (light theme) | Company name and light logo |
| Sidebar and header (dark theme) | Dark logo |
| Browser tab | Favicon |
| Outbound emails | Company name |
Troubleshooting
| Symptom | What to do |
|---|---|
| Upload rejected on save | Check the format and size. Logos must be PNG, JPG, SVG, or WebP up to 2 MB; favicons must be PNG, ICO, or SVG up to 512 KB. |
| Dark logo looks invisible or low-contrast | Upload a light-coloured version to the Logo (dark background) slot. The dark preview tile shows how it reads against the dark sidebar. |
| New logo or favicon doesn't show yet | The page reloads with the updated preview after you save. If a browser tab still shows the old favicon, reload the tab or clear its cache — browsers cache favicons aggressively. |
| Company name didn't change | Confirm you selected Save changes at the bottom of the page, not just edited the field. A blank field keeps the default name. |