Zimbra 9/Modern Web App
- 1 Introducing the Modern Web Application
- 1.1 Overview
- 1.2 Responsive Design
- 1.3 Current Technology
- 1.4 Supports Modern Browsers
- 1.5 Customization and Extensible User Interface
- 1.6 Zimlet Integrations
- 1.7 Co-Existence with Classic Web Application
- 1.8 Exclusive Features
- 1.9 User Documentation
- 1.10 Known Issues
Introducing the Modern Web Application
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.
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.
The Modern Web Application incorporates a leading-edge technology stack focused on speed, scalability, and reliability, including:
- - PreactJS, a component-based UI framework.
- - GraphQL, an extensible data API language based on datagraphs.
- - 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||Y||Y||Y|
|MacOS||10.13 or newer||Y||Y||Y|
|Linux||Red Hat, Ubuntu, Fedora, or SUSE||Y||Y|
|Android phone or tablet||Latest still supported by Google||Y|
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.
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.
"Zimbra Modern Zimlets" provide access to the best of collaboration applications with out-of-the-box integrations for:
...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.
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
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.
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:
|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. |
|Calendar|| Right-clicking an event in the Calendar sometimes opens the browser-default action menu instead of the events context menu.|
Workaround - Users may right-click on the event a second time to view the event’s context menu.
|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. |
|Folders nested deeper than 5 levels do not appear in the folder list pane.|
|For some messages, the HTML content of a message that contains links for external images is only partially displayed.|
| 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.
|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).|
| Some ics files fail to get imported via Calendar → Import.|
Workaround - Such files can be imported using Classic UI.
| 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.
| 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.
| 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.
| 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.
|The application marks the entire conversation thread as read if users have read just the latest message.|
|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.|
|Users cannot create a nested folder by dragging and dropping it into another folder.|
|When user selects all messages in a folder and moves or delete them, the first message remains open in the preview pane.|
| 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|| When user tries to print an email from a Search result, it results in a "Not Found" error page|
Workaround - Print the email from the mail list.
|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|| The Modern Web App freezes after the user specifies an invalid date when setting an out-of-office response.|
Workaround - User can do hard reload of the app.
|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.|
|Mobile and Tablet||In Mobile View, nested folders do not correctly indent with deeper levels of sub-folders.|
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. »
Other Help Resources
Looking for a Video?
Visit our YouTube Channel to keep posted about Webinars, technology news, Product overviews and more.
Go to the YouTube Channel »