Zimbra 9/Modern Web App

Revision as of 20:32, 11 June 2020 by David Bingham (talk | contribs)

Introducing the Modern Web Application

   KB 23930        Last updated on 2020-06-11  

(0 votes)


Zimbra's Modern Web Application is a new client for Zimbra Collaboration, built from the ground up to provide a clean and simple user experience on any device.

It offers a responsive user interface that is easy to use across devices, has intuitive navigation, supports customizations, is secure and accessible.

The Modern Web Client has been built for Zimbra X but is offered with Zimbra Collaboration Release 9.0.0 to all customers who have a Network Edition license.

Responsive Design

MWA Screens.png

By following Responsive Web Design principles, Zimbra's Modern Web Application ensures that users get a consistent experience and full functionality across all their devices. Instead of forcing users to adapt to completely different interfaces, the Modern Web App lets them engage with the same interface everywhere while it adapts for them.

Current Technology

The Modern Web Application incorporates a leading-edge technology stack focused on speed, scalability, and reliability, including:

  • Preact.jpg - PreactJS, a component-based UI framework.
  • GraphQL.png - GraphQL, an extensible data API language based on datagraphs.
  • Apollo.png - Apollo, a GraphQL implementation with advanced cache management capabilities.

Supports Modern Browsers

The following operating system/browser combinations are supported:

OS Versions Google Chrome Firefox Microsoft Edge Safari
Windows 8.1 or 10
MacOS 10.13 or newer
Linux Red Hat, Ubuntu, Fedora, or SUSE
Android phone or tablet Latest still supported by Google
iOS Latest

In all cases, it is expected that OS updates are current and that the browser software is the latest stable release.

Reference: This information is derived from the System Requirements section of the Zimbra 9 Installation Guide.

Customization and Extensible User Interface


Like the Zimbra Web Client (ZWC, or the Classic Web Application in Zimbra 9), Zimbra's Modern Web Application supports branding and customization of colors, fonts, logos, and external site navigation - but unlike Classic, Modern Zimlets can be supported across all devices.

Exclusive and custom features can be delivered using the new Zimlet framework. In Zimbra 9, there is no change to the administration of Modern Zimlets; they can be managed by Domain, COS, or per-user, exactly like Classic Zimlets.

Within this framework, Zimlets work consistently across all devices: desktop, tablet, and mobile.

Zimlet Sideloader

The security model of the Modern Zimlet Framework requires Zimlets to integrate with the UI code through an API that bridges Preact components and the GraphQL interface to them.

To support running Zimlets-under-development, the Admin must deploy a special Sideloader Zimlet and enable it for the test account. Use this command as the zimbra user to deploy it:

zmzimletctl deploy zm-x-zimlet-sideloader.zip

Here is a practical guide to writing Preact Zimlets for Zimbra 9 and above.

Zimlet Integrations

"Zimbra Modern Zimlets" provide access to the best of collaboration applications with out-of-the-box integrations for:

Slack instant messaging Zoom meetings Dropbox cloud file management Google Drive
Onde Drive

...and more on the way!'

Co-Existence with Classic Web Application

In Zimbra 9, the Modern Web Application coexists with the Classic Web Application (formerly Zimbra Web Client / ZWC), which provides the user experience that Zimbra 8 users are familiar with, and all the same features and Zimlets.

Users can choose either Web Application during login when using desktop browsers in Windows or macOS, and can easily switch between them if needed, for example, to utilize a Zimlet in Classic that is not yet available in Modern.

Exclusive Features

A number of features are unique to the Modern Web App and are not available in the Classic Web App.

  • Installable as a Progressive Web App.
  • QR Code for easier configuration of two-factor authentication.
  • User Session Management (Standard Zimlet) - Users can view all their active sessions, and terminate any they don't recognize or want.
  • User preference for Date and Time formats.
  • Unified calendar & tasks
  • Special-purpose calendars, e.g. Holiday Calendars (Standard Zimlet)
  • Basic & Advanced Filters in Settings

User Documentation

The user guide is available in HTML format: Zimbra 9 User Guide

The documentation has been initially published in English, with additional languages to come.

Known Issues

The Modern Web Application is being actively developed and does not yet support all features that are available through the Classic Web Application; remember that it is easy to switch between the Applications in desktop browsers to use features that aren't yet available in the Modern Web Application. You can identify such roadmap features in the Zimbra 9 Admin Guide; look for the notes highlighting them.

The following list summarizes issues known to the Zimbra developers that are anticipated to be impactful to users, and are planned for resolution in future patch releases.

General A subset of Zimbra languages are supported, limited to:
  • Chinese (China) - 中文 (中国)
  • Chinese (Hong Kong SAR China) - 中文 (香港)BETA
  • Chinese (Taiwan) - 中文 (台灣)BETA
  • Dutch - NederlandsBETA
  • English (United States) - English (United States)
  • French (France) - français (France)
  • German - Deutsch
  • Hindi - हिंदी
  • Indonesian - Bahasa Indonesia
  • Italian - italiano
  • Japanese - 日本語
  • Korean - 한국어BETA
  • Polish - polskiBETA
  • Portuguese - portuguêsBETA
  • Portuguese (Brazil) - português (Brasil)
  • Russian - русскийBETA
  • Spanish - español
  • Thai - ไทย
  • Vietnamese - Tiếng Việt
General After upgrading to the latest version of the web app, intermittently, some components of the app do not load.
Workaround – Users may reload the web app.
General Messages from the search list or tag folder cannot be moved using Drag and Drop.
Calendar When organizers delete an event and later restore it using undo-event-deletion (click Undo on event Deleted notification), the event restores in the organizers' Calendar but not in invitees' Calendar.
Workaround - Organizer may forward the event to all invitees.
Calendar When editing events in shared calendars, if users add a recipient and save the event to send it, the invitation is not sent to the added user.
Workaround – The organizer may add the new recipients.
Calendar Declined events are never shown in the calendar, as the "Show declined event" preference is not supported.
Workaround - Users may locate the invitation email in Trash to change their original event response.
Calendar When the Calendar Feature is disabled for a COS (Class of Service) or a user, i.e. ZimbraFeatureCalendarEnabled = FALSE, then if such a user receives an event invitation, the event invitation is displayed with calendar event icon in the mail list.
Calendar When a user who has selected 24-hour time format is creating new events, the 24-hour time format is not displayed for English (US) language.
Workaround – Users may choose to create the event in the 12-hour format.
Contacts When sharing is disabled for a user, i.e. zimbraFeatureSharingEnabled = FALSE, the GAL folder is not visible in Contacts vertical for that user. Users can still search for GAL contacts in search bar, and GAL contacts are auto-completed in To/CC/BCC fields when composing a mail.
Mail Folders nested deeper than 5 levels do not appear in the folder list pane.
Mail For some messages, the HTML content of a message that contains links for external images is only partially displayed.
Mail In Conversation View, users cannot move multiple emails between folders if one of the email threads contains a draft.
Workaround – When selecting multiple messages to move, users may avoid selecting the conversations which contain a draft.
Mail Users' Drafts folder (under the external IMAP account configured with the application) does not synchronize with its respective account on external domains (e.g., Gmail, Yahoo).
Mail When the user has set the Preview pane to Bottom of the screen, and tries to preview an email attachment, it results in an inconsistent user interface and blank email list
Workaround - Use right-side preview pane to preview attachments.page.
Mail In Message view, if the user selects a message and clicks Reply/ReplyAll/Forward, then closes the tab, they will land in the mail list with the same email selected. If the user again clicks Reply/ReplyAll/Forward, it does not work.
Workaround - The user may select another message and then re-select the previous message for Reply/ReplyAll/Forward.
Mail If users type a subject while the attachment upload is in progress, the typed subject clears after the upload process completes.
Workaround - Users can wait to update the subject until the attachment upload completes.
Mail In Message View, Standard Signature set by the user is not populated when performing Reply/Reply All/Forward actions.
Workaround – The signature will populate if users have set their “Reply or forward signature” under Settings → Signatures.
Mail The application marks the entire conversation thread as read if users have read just the latest message.
Mail When a user selects read emails and then uses right-click, the context menu displays the "Mark as Read" option enabled, although it will do nothing.
Mail Users cannot create a nested folder by dragging and dropping it into another folder.
Mail When user selects all messages in a folder and moves or delete them, the first message remains open in the preview pane.
Mail In Message view, if the user selects a message and clicks Reply/ReplyAll/Forward, then closes the tab, he will land in the mail list with the same email selected. If the user again clicks Reply/ReplyAll/Forward, it does not work.
Workaround - The user may select another message and then re-select the previous message for Reply/ReplyAll/Forward.
Search If users try to preview an attachment through search results, the search results hide.
Workaround – Users may download the attachment to view it.
Settings Users can’t configure another Zimbra mail account as a secondary IMAP/POP3 account.
Workaround - Users can do this setup in Preferences > Accounts in the Classic Web App, and still use the account in Modern.
Settings User is able to save invalid dates while configuring out of office response.

Browser- or Platform-Specific issues

Internet Explorer Internet Explorer cannot support the Modern Web App. Please upgrade your browser to the latest version of MS Edge, Chrome, Firefox or Safari.
Safari Safari users do not see the contents of the Mail and Calendar tab until they clear Safari’s cache.
Safari When using the web app in Safari, if there are any events in users' Calendars that were created through CalDav, right-clicking them leaves the user interface distorted. The user has to reload the browser to use the app again.
Safari In the Safari browser for macOS, users are not able to use the horizontal scrollbar in the message-reading pane to view the complete message.
MS Edge When users try to drag-and-drop filters in the MS Edge or Mozilla Firefox browser, the web application stops responding. Reloading helps recover the web application.
MS Edge In the MS Edge browser, dragging or resizing the left navigation panel results in a distorted UI. Reloading helps restore the web application. Workaround – Users may use Chrome or Firefox browser to avoid these browser-specific issues.
Mobile and Tablet In the Mobile view, when users tap on the extreme right side of the email in the list view, emails get deleted or starred. Users may use the ‘Undo Delete’ functionality or navigate to the Trash folder to recover the deleted email.
Mobile and Tablet iPad users are unable to open the web application when using Safari (version 9).
Mobile and Tablet iOS users have to double-tap an email to view it in the reading pane. Single-tap only highlights the email and does not open it in the reading pane.
Mobile and Tablet When user changes the date format in mobile from Settings→General, the changed date format is not used when creating a new event. Instead, Mobile OS date format is used.

Try Zimbra

Try now Zimbra Collaboration without any cost with the 60-day free Trial.
Get it now »

Want to get involved?

You can contribute in the Community, in the Wiki, in the Code, or developing Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube Channel to keep posted about Webinars, technology news, Product overviews and more.
Go to the YouTube Channel »

Verified Against: Zimbra 9 Date Created: 04/07/2020
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_9/Modern_Web_App Date Modified: 2020-06-11

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search