Documentation

Your company logo in webmail and Colabora

The domain administrator changes the logo in the admin panel, and it shows to the domain's users after they sign in, in webmail and Colabora, instead of the Lua logo. It is included in every plan, with no license and no charge. Step by step with example screens (fictional data).

On this page
  1. What it is and who can change it
  2. Image format and size
  3. Step by step in the admin panel
  4. Logo for the dark theme
  5. How it looks in webmail and Colabora
  6. Change or remove the logo
  7. Domain logo vs. white label
  8. Frequently asked questions

1. What it is and who can change it

The logo shows to the users of your domain after they sign in to webmail and Colabora, instead of the Lua logo.

  • Who changes it: the administrator with access to the domain in the admin panel, and the Lua team. Regular users cannot.
  • Cost: included in every plan, per domain, with no license and no charge.
  • When it shows: after sign-in. The sign-in page keeps the Lua brand, because the person's domain is not known yet.
  • Where it applies: in the Lua+ and Lua Next webmail themes and in Colabora. Only the logo changes: colors, theme, name and texts stay Lua's.

2. Image format and size

  • Formats: PNG, JPEG or WEBP. SVG and GIF are not accepted. The admin panel checks the type from the file contents, not from the extension.
  • Limits: up to 2 MB and up to 4000 × 4000 pixels.
  • Automatic resizing: the admin panel scales the image down to fit the header (at most 640 × 128 pixels, double 320 × 64 for high-resolution screens) and never enlarges it.
  • Ideal: a PNG or WEBP with a transparent background, in a nearly square format, from 1:1 up to 2:1 (width at most 2 times the height, such as 400 × 260 pixels), preferably with the version for dark backgrounds (chapter 4).

Use a nearly square logo, up to 2:1, with a transparent background (PNG or WEBP), preferably with the version for dark backgrounds. It shows in the header at about 28 px tall at most. In practice the space is small: in webmail (version 1.6) a nearly square logo, at 1.5:1, shows at about 29 × 19 px, and a wide 4:1 logo ends up at about 28 × 7 px. So keep it to a few shapes and large letters; taglines, slogans and photos turn into a blur.

A nearly square logo, with a star and the word Estrela, readable at the header size
Good: a nearly square logo (1.5:1), with few shapes and large letters, in the version for dark backgrounds. Fictional image at the header size (28 × 28 px), enlarged 4 times.
A very wide logo, with a long name and a tagline in small letters, reduced to an unreadable line at the header size
Bad: a very wide logo (10:1), with a long name and small text: in the header it becomes a line. Fictional image at the header size (28 × 28 px), enlarged 4 times.

If the image is wider than 2:1, the admin panel shows the warning This logo is very wide and may be hard to read in the header. The warning does not block you: you can save anyway, but it is worth switching to a shorter version.

3. Step by step in the admin panel

  1. Sign in to the admin panel and open Domains.
  2. Click the domain and, in the tabs, click Configure domain (in the admin panel, Domain settings).
  3. Find the Logo in webmail and Colabora card.
  4. Under Logo (light theme), choose the file. The Webmail header preview shows how it will look, in the light and dark themes, before you save.
  5. Click Save logo.
Domain settings tab of the admin panel, with the Logo in webmail and Colabora card below the domain time zone
Figure 1: The logo card is in the Configure domain tab. Fictional domain (Padaria Estrela).

While the domain has no logo of its own, the card says webmail shows the Lua logo. The previews show the header with the Lua logo (default).

Logo in webmail and Colabora card with no logo of its own, with the Logo (light theme) and Dark theme logo fields and the previews showing the Lua logo
Figure 2: Card with no logo of its own.
Card with the logo file chosen and the header preview showing the Estrela logo in the light and dark themes
Figure 3: With the file chosen, the preview shows the header before you save.

If the file is not accepted (wrong format, too large), the admin panel shows the reason and nothing is saved. After saving, the card shows Own logo in use, with the date and who updated it.

On a phone, the admin panel uses the same screen, with the fields and previews stacked one below the other.

Logo in webmail and Colabora card in the admin panel on a phone, with fields and previews in one column
Figure 4: The card on a phone.

4. Logo for the dark theme

The second field, Dark theme logo (optional), is for uploading a light version of the logo that looks good on a dark background. The header bar in webmail (Lua+ and Lua Next) and in Colabora is dark in both themes, so this version applies to both the light and the dark theme.

  • With the dark theme logo: it shows in both themes, with no background.
  • Without the dark theme logo: the domain logo shows on a rounded light background, in both themes (light and dark), so it does not disappear on the dark bar.
Card with the light logo and the dark theme logo chosen, with the preview showing the light logo on a dark background
Figure 5: Preview with the dark theme logo chosen.
Card with the Own logo in use and With a dark theme logo badges, the previews and the Save logo and Remove the logo and go back to Lua's buttons
Figure 6: Logo saved, with the dark theme version.

To remove only the dark theme logo, check Remove the dark theme logo and save.

5. How it looks in webmail and Colabora

The logo shows in the top left corner after sign-in, in webmail and in Colabora. The header bar is dark in both themes (light and dark), and the rule is the same in both. The crops below are of the header, with fictional test logos.

In the webmail

Webmail crops (version 1.6), enlarged. The header is the same in the Lua+ and Lua Next themes.

Top left corner of webmail with the light version of the Estrela logo, with no background
With the dark theme logo: shows with no background, in both themes
Top left corner of webmail with the Estrela logo on a rounded light background
Without the dark theme logo: rounded light background, in both themes
Top left corner of webmail with the Lua symbol, with no logo of its own
No logo of its own: the Lua brand

In Colabora

Colabora uses the same logo and the same rule, in the top header. Colabora crops, on the computer and on the phone, with test logos.

Colabora header with the version of the logo for dark backgrounds, with no background
With the dark theme logo: shows with no background, in both themes
Colabora header in the light theme with the logo on a rounded light background
Without the dark theme logo, light theme: rounded light background
Colabora header in the dark theme with the logo on a rounded light background
Without the dark theme logo, dark theme: rounded light background
Colabora header on a phone with the logo on a rounded light background
On your phone

The webmail and Colabora sign-in page keeps the Lua brand.

How long it takes

The logo shows at the next sign-in. People who already have webmail open see it within about 10 minutes.

6. Change or remove the logo

  • Change: choose a new file in the same card and click Save logo.
  • Remove: click Remove the logo and go back to Lua's and confirm. Webmail goes back to showing the Lua logo for the domain's mailboxes, and you can upload the logo again whenever you want.
Remove the logo and go back to Lua's window, with the Cancel and Confirm buttons
Figure 7: Confirmation when removing the logo.

7. Domain logo vs. white label

Domain logoWhite label
What it isJust the logo image.The full brand on your own address (for example, webmail.yourcompany.com).
Who turns it onYou, in the admin panel.You, in the panel (Domain settings → Webmail with your brand).
How to get itIncluded in every plan, at no cost.Per domain, at no cost for now.
Accepted formatsPNG, JPEG and WEBP (no GIF or SVG).PNG, JPEG, GIF and WEBP (SVG does not go in directly; the simulator converts it).
Sign-in pageKeeps the Lua brand.Shows the white label logo.

If your company uses its own address with white label, the domain logo replaces only the header logo after sign-in. The rest of the brand (name, colors, theme, symbol and support) stays the same, and the sign-in page at that address keeps the white label logo.

They are different things, with different image rules: the domain logo refuses GIF; the full whitelabel accepts GIF. To learn about the whitelabel and preview your company's brand, see Your logo in webmail and Colabora (full brand); the upload steps are in the panel manual, and the DNS steps (without them the addresses do not open) are in Set up the DNS. When you confirm the brand, the addresses are turned on by themselves and, once they are ready, the domain administrators get an email.

8. Frequently asked questions

Why does the sign-in page still show the Lua logo?

Because the system only finds out the person's domain after sign-in: before that, it does not know which logo to show. After signing in, webmail and Colabora show your company logo.

Why does my logo show on a light rectangle?

The header bar in webmail and Colabora is dark in both themes. Without the version for dark backgrounds, the domain logo goes on a rounded light background, in both themes, so it does not disappear. For it to show with no background, also upload the dark theme logo: a light version with a transparent background.

How long does it take for the logo to show?

At the next sign-in. People who already have webmail open see the new logo within about 10 minutes, without signing out.

Can I use SVG?

No. An SVG file can contain code, so for security the admin panel accepts only PNG, JPEG and WEBP. Export the logo as a PNG with a transparent background.

Is the Colabora logo the same ones you use in the webmail one?

Yes. It is the same logo, and it applies to both webmail and Colabora: when you save it in the admin panel, it shows in both.

Does it cost anything or need a license?

No. The domain logo is included in every plan, per domain, with no license and no charge.

Who can change the logo?

The administrator with access to the domain in the admin panel, and the Lua team. A regular user, without administration access to the domain, cannot.

Is this the same as white label?

No. The whitelabel is the company's full brand on its own address, which you turn on yourself in the panel, per domain and at no cost for now. The domain logo is just the image, also changed in the panel. See the comparison in chapter 7.

Still need help?

Contact support. A person on Lua support answers, based in Brazil, in Portuguese.

To speed things up, include the domain and, if the logo does not show, when you saved it and which webmail theme you use (light or dark).