Manage Your Webmail Interface Branding

Branding lets you change the look and feel of the Webmail interface so it represents your company — including logos, type face, colours, and ads or dynamic content. You manage brands from the Email section of the OpenSRS Control Panel and apply them company-wide, per domain, or per user. This guide covers the full workflow: create, customize, and assign a brand.

The three phases of managing a brand

1. Create the brand. Every new brand starts as a copy of the default brand.
2. Design or customize the brand. Adjust logos, colours, components, login page, and more.
3. Assign the brand. Apply it to a company, a specific domain, or an individual user.

Before you begin

• Sign in to the OpenSRS Control Panel with an account that can manage email brands.
• Prepare brand assets: header image, footer image, sidebar ad image, and colour values.
• Decide the scope — company-wide default, per domain, or per user — for each brand.
• If you plan to create a custom login page, have your logo file ready to upload to the brand files.

Step 1: Create a new brand

1. In the Email section of the Control Panel, open your company page and click the Brands tab.
2. Click the Add icon at the top of the page.
3. In the Add a Webmail Brand popup, enter a name for your brand and click Add. The new brand is added to the list of available themes.
4. On the Brands page, click the brand name to open the Editing brand window.

Step 2: Customize brand settings

The brand editor groups settings into these sections:

Step 3: Set the default brand for a company

A company-level brand applies to every domain and user under that company, unless overridden lower down.

1. In the Email section of the Control Panel, open your company page and click the Settings tab.
2. In the Domain and User Inheritance section, click Edit.
3. Under Brand, select the checkbox beside Override inherited value.
4. From the drop-down, choose the brand you want to apply.
5. Click Save.

Step 4: Assign a brand to a specific domain

Override the company default for a single domain when that domain needs its own look.

1. In the Email section of the Control Panel, click the Email Domains tab and select the domain you want to brand.
2. Click the Settings tab.
3. In the User Inheritance section, click Edit.
4. Under Brand, select the checkbox beside Override inherited value.
5. From the drop-down, choose the brand for this domain.
6. Click Save.

Step 5: Create a custom webmail login page

A custom login page replaces the default page at mail.yourdomain.com with your own HTML.

1. In the Email section of the Control Panel, open your company page and click the Brands tab.
2. Click the brand you want to update.
3. Under Custom Login Page, click Edit.
4. For Display, click Enable.
5. Add your custom HTML. The example below shows the minimum scaffold — replace logo.jpg with the filename you uploaded under Files.

<!-- Reseller Access - Custom Login Page -->
<style>
  body { url(images/linen.jpg) repeat #d1d5d8; }
</style>
<div id="login-form">
  <div id="login-logo">
    <img src="%%DIR%%/content/logo.jpg" id="logo">
  </div>
  <div class="box-inner">
    %%LOGIN_FORM%%
  </div>
</div>

Next steps

• Tune brand inheritance. Audit company, domain, and user overrides so each end user sees the right brand.
• Match your other surfaces. Apply consistent branding to reseller and confirmation pages — see Manage Reseller Branding and Brand and Customize Confirmation Pages.
• Test the custom login page. Visit mail.yourdomain.com in a private window to confirm your logo, layout, and login form all render correctly.

Questions? Contact OpenSRS Support.