📧 amber Outlook Add-in – Administrator

This guide explains how administrators can deploy the amber Outlook Add-in to all users in their organization via Microsoft 365 Integrated Apps, and how end users can work with each feature of the Add-in.

Prerequisites

  • A Microsoft 365 tenant with Exchange Online mailboxes

  • Admin access to the Microsoft 365 Admin Center

  • Your amber instance URL (provided by your amber contact)

  • Outlook desktop (Windows/macOS) or Outlook on the web — Outlook 2016 or later

For Administrators: Deploying via Integrated Apps

Step 1 – Get Your Manifest Link

Copy your custom domain XML manifest link below:

https://customDomain.ambersearch.de/outlook/manifest.xml

Note: Replace customDomain with your dedicated domain provided by amber (e.g. https://yourcompany.ambersearch.de/outlook/manifest.xml). This domain was shared with you by your amber contact during onboarding.

You will paste this link into the "Provide link to manifest file" field in the next step.

Step 2 – Upload to Microsoft 365 Admin Center

  1. Open the Microsoft 365 Admin Center and sign in as a Global Administrator or Exchange Administrator.

  2. In the left navigation, go to Settings → Integrated apps.

  3. Click Upload custom apps.

  4. In the dialog, select Office Add-in as the app type.

  5. Choose Provide link to manifest file.

  6. Paste the manifest link copied in Step 1 and click Validate.

  7. Review the permissions summary:

    • ReadWriteMailbox – required for reading email content and inserting drafts.

  8. Click Next to proceed to the user assignment step.

Step 3 – Assign to Users

On the Assign users screen you can control who receives the Add-in:

Option

When to use

Entire organization

Roll out to all licensed users at once

Specific users / groups

Pilot with a smaller group before a full rollout

Just me

Personal testing only

Select the appropriate scope, then click Next → Finish deployment.

Deployment propagation may take up to 24 hours before the Add-in appears in users' Outlook clients.

Step 4 – Verify Deployment

  1. Ask a test user to open Outlook on the Web or Outlook Desktop and open any email.

  2. In the email toolbar, they should see the amber button.

  3. If it does not appear, check:

    • The manifest URL is reachable from the user's network.

    • The user is in the assigned group.

    • At least 24 hours have passed since deployment.

For Users: See the User manual here:

https://helpcenter.ambersearch.de/en/help/articles/2220173-e-mail-outlook-add-in-for-users