Customizing the Modern UI theme colors and logo

With the Simple Theme customizer Zimlet you can change the Modern UI
appearance in a fast and easy way. Simple Theme customizer Zimlet
supports setting the primary and secondary color and the logo on Zimbra
Modern UI. You can set these settings globally or per domain.

Configuring and installing

Create a file /tmp/zimbra-zimlet-simple-theme.xml with the following
content:

<zimletConfig name="zimbra-zimlet-simple-theme" version="0.0.1">
    <global>
        <property name="primaryColor">#ff0000</property>
        <property name="secondaryColor">#fbcebd</property>
        <property name="logo">url(data:image/png;base64,iVBORw0 ... 5ErkJggg==)</property>
    </global>
</zimletConfig>

To set a property for a specific domain you can prepend the domain with
a hyphen (-) like this:

<property name="example.com-primaryColor">#ffff00</property>

You can use a HTML color picker to find the color codes:
https://htmlcolorcodes.com/color-picker/

The Zimlet uses CSS so you can set the logo via a URL or probably better
by using a so-called data-uri:

url('https://www.zimbra.com/wp-content/uploads/2016/06/zimbra-logo-color-282.png')
url(data:image/png;base64,iVBORw0 ... 5ErkJggg==)

The benefits of using a data-uri is that the image data is stored on
Zimbra. So you do not rely on some URL that may become unavailable in
the future. You can create a data-uri by using
https://www.cssportal.com/image-to-data/ or
https://ezgif.com/image-to-datauri.

You can see a full example of
config_template.xml at
https://raw.githubusercontent.com/Zimbra/zimbra-zimlet-simple-theme/main/config_template.xml.

Finally install and configure the Zimlet:

cd /tmp
wget https://github.com/Zimbra/zimbra-zimlet-simple-theme/releases/download/0.0.1/zimbra-zimlet-simple-theme.zip -O /tmp/zimbra-zimlet-simple-theme.zip
zmzimletctl deploy zimbra-zimlet-simple-theme.zip
zmzimletctl configure /tmp/zimbra-zimlet-simple-theme.xml
zmprov fc all

Screenshots

image The default Modern UI
colors.

image Modern UI after installation
of Simple Theme customizer Zimlet.

, ,

2 Responses to Customizing the Modern UI theme colors and logo

  1. Namu November 3, 2022 at 12:49 AM #

    Hi, I have done this and its working on some but not others could please assist

    Zimbra Modern Web App Version 4.28.1 (build b6026b291, date 20220927145259)
    Server Version 9.0.0_GA_4465 (build 20220923110020)
    Connected to server

Copyright © 2022 Zimbra, Inc. All rights reserved.

All information contained in this blog is intended for informational purposes only. Synacor, Inc. is not responsible or liable in any manner for the use or misuse of any technical content provided herein. No specific or implied warranty is provided in association with the information or application of the information provided herein, including, but not limited to, use, misuse or distribution of such information by any user. The user assumes any and all risk pertaining to the use or distribution in any form of any subject matter contained in this blog.

Legal Information | Privacy Policy | Do Not Sell My Personal Information | CCPA Disclosures