contentACCESS MailApp vNext – version 6.1

2.Configuration part for administrators

The configuration of the contentACCESS MailApp vNext is similar to the other MailApp configuration (read more about the legacy MailApp configuration here). The only exception is that if the administrator wants to install the contentACCESS MailApp vNext, the Deploy MailApp vNext checkbox needs to be selected first in the: Email archive => System settings => General settings section.

Important: The new MailApp requires WebView2 to run correctly (Find more information about the WebView2 here or download it directly from here.). WebView2 is supported on O365 Outlook, and Office 2016, 2019, and 2021. BUT Office 2016 and 2019 must fulfill some conditions to support WebView2. For more information read this article.
Users who use Office 2016 or 2019 with a volume license must download and install the previous contentACCESS MailApp. The new contentACCESS app works only with the retail license in Office 2016 and 2019.

The administrator is required to do the following configurations for manual email archiving. He has to:

  1. configure a shortcut that the MailApp will use and set this shortcut as default (refer to section Shortcuts in email archiving);
  2. configure a retention that the MailApp will use and set this retention as default (refer to section Retentions);
  3. install the Proxy server with HTTPS connection;
  4. configure HTTPS based alias In Central Administration under System => Services => System => External accessibility settings;
  5. allow MailApp activation for selected mailboxes/groups/servers from Central Administration => Address book;
  6. run the Email archive Provisioning job to apply the changes.

To allow the MailApp activation, navigate to Email Archive ⇒ Archive ⇒ View address book on the ribbon.


In the column Enable Mail app it is possible to see if the MailApp activation was allowed for the selected object (mailbox, group, or server). By default, the objects inherit the MailApp activation from their parent, so if the parent has it set to allow/forbid, so will the child.


The MailApp activation can be set from the context menu of the selected object to:

  • Inherit
  • Explicitly allow
  • Explicitly forbid.


If you selected Explicitly allow, the contentACCESS Portal user role pop-up will open. Here you need to specify the contentACCESS Portal user role (containing user permissions) to be assigned to the contentACCESS Portal user(s). It is possible to select a custom role from the dropdown list or you can use the role defined in the Email archive Provisioning job.

After the changes have been made, it is necessary to start the Provisioning job to apply them.

When the Provisioning job finishes the run, the new contentACCESS MailApp vNext version should appear in the user’s mailbox.

Note: After the Mail app was activated, it is recommended to restart your Outlook.

Important: To successfully install the MailApp, the Exchange server must have access to the contentACCESS server and to the MailApp’s .xml manifest file. The manifest file can be accessed using the following links:

  • https://[SERVERNAME]/contentACCESSWS/Mailapp/Mailapp.xml
  • https://[SERVERNAME]/contentACCESSWS/Mailapp/Mailapp_no_ribbon_button.xml

The administrator should be able to browse the file using the links above without any issues.

If the user wants to configure the legacy MailApp, the check-in Deploy MailApp vNext step should be skipped. It is also possible to switch back to the legacy MailApp from the contentACCESS MailApp vNext by the following steps:

      1. go to Email archive => Archive => View address book => Groups section
      2. select the group to whom you want to restore the previous version => Mail app activation => Explicitly forbid
      3. after the changes have been made, it is necessary to start the Provisioning job to apply them
      4. then go to the Email archive => System settings => General settings section, and disable the Deploy MailApp vNext option
      5. go back to the View address book – Groups section, and select Mail app activation => Explicitly enable, then start the Provisioning job to apply the changes. After this, the legacy MailApp will be displayed in the users’ mailboxes
Yes No Suggest edit
Help Guide Powered by Documentor
Suggest Edit