Setting up Ideagen Mail Manager in New Outlook
Who is this article for?
Users who want to use the desktop app with New Outlook.
Mail Manager Desktop v15.4 or later is required. (Help > About Mail Manager)
This article explains how to prepare your system, install the web add‑in, and enable the latest version of Outlook while continuing to use your usual filing workflows.
1. Prerequisites
Before installing, make sure your PC meets all of the following requirements.
1.1. Operating system
- Windows 10 or Windows 11 (64‑bit only) is supported.
- Windows 8.1 (64‑bit) is untested but should work.
- Server versions of Microsoft Windows 2012 and later are untested but should work.
1.2. Hardware
- An Intel processor running at 2.5 GHz or faster with at least two cores.
- 8 GB RAM or more.
- A minimum screen resolution of 1280 × 768.
- Microsoft .NET Framework 4.8 or newer installed.
1.3. Microsoft Outlook
- A licensed Windows version of Microsoft 365 or Outlook 2019 must be installed. Classic Outlook must be present on the machine.
- New Outlook or Outlook on the web uses a web add‑in. This is not compatible with the existing web add‑in, so remove any previously installed web add‑ins before continuing.
- A working and tested version of Ideagen Mail Manager must be installed.
- Your mailbox must be hosted on Exchange Online.
- The mailbox must be set up as the Primary Account in the Classic Outlook profile with Cached Exchange Mode enabled. It must be opened at least once to allow the initial folder sync to complete.
1.4. SharePoint
- Your organisation must use Microsoft 365, and you need your organisation’s SharePoint tenant address (for example, https://tenant.sharepoint.com).
2. Preparation - Approve the Microsoft Consent
Before installation, a Microsoft 365 Administrator must approve the desktop app’s Web add‑in for the organisation’s SharePoint tenant.
Note
This version works with a single primary mail account only.
2.1. Microsoft sign-in
New Outlook needs a Microsoft sign-in (Microsoft Graph) for your account.
This should pop up for each user (once) after step 4 is completed below.
3. Install the New Outlook web add‑in
You must deploy the web add‑in either to each machine individually or in bulk through the MS365 admin centre.
Do not install this web add in for mac users or non Mail Manager users.
3.1. How to install the web add in for a single user
To install the add‑in for one user, follow these steps below. Or review our separate help article here
- Open the manifest file.
- Right‑click anywhere on the page.
- Select Save As.
- Save the file as an .xml file.
- Follow Microsoft’s instructions for installing custom add‑ins.
Note: If you do not see the option to add a custom add‑in, your administrator must install the web add‑in for you. See the steps for multiple users below. Note that on some machines Microsoft's short link doesn't work; on those, use the longer version: https://outlook.office.com/mail/inclientstore
3.2. How to install the web add in for multiple users
The basic steps for organisation‑wide deployment are listed here. These may vary slightly depending on Microsoft updates. You can find the full guidance in Microsoft’s documentation on deploying add‑ins in your organisation. We also have a separate article on this process here
To deploy the add‑in across multiple machines:
- Open the manifest file.
- Right‑click anywhere on the page.
- Select Save As.
- Save the file as an .xml file.
- Go to the Microsoft 365 admin centre.
- Open Settings.
- Select Integrated apps.
- Select Upload custom apps.
- Select Office Add‑in from the App type dropdown.
- Upload the manifest file.
- Choose whether to assign the add‑in to everyone or to specific users or groups.
- Select Deploy to complete the installation.
Note: Once an integrated app is deployed via the Microsoft 365 admin center, it typically becomes available to assigned users within 15 to 60 minutes; however, in some cases, propagation may take up to 24 hours to complete across all Microsoft 365 services and client applications. In rare edge cases propagation may take up to 72 hours.
4. Enabling the new Outlook version
Once your PC meets the prerequisites and the add‑in has been deployed, you can enable the new version on the user’s machine.
To enable the new version:
- Open Classic Outlook.
- If you are not prompted automatically, select Check for updates.
- Complete any installation or update steps.
- Close and reopen Classic Outlook.
- Go to Mail Manager > Tools > User Preferences.
- Click on Microsoft 365
-
Ensure your SharePoint tenant is listed as below in the format of https://tenant.sharepoint.com
this is usually https://YourCompanyname.SharePoint.com or your SharePoint web address.
Your admin can also apply this company wide, See the example below: - Go to New Outlook,
-
Select Enable Windows desktop support for New Outlook.
- Select OK.
The update may take a few minutes. During this time, your existing Mail Manager icons in Classic Outlook will become inactive.
You can then open New Outlook or Outlook on the web on this computer.
Tip
You can opt out at any time by switching back to Classic Outlook.
Buttons on the ribbon do not display in New Outlook as they do in the Classic Outlook, as the rest of those options are all found by clicking the MM icon in the system tray, as the MM icon in the New Outlook window is just to trigger a filing.
Troubleshooting
Please follow the steps here: Troubleshooting Ideagen Mail Manager desktop with New Outlook