---
title: "Outlook Add-in overview"
slug: "outlook-add-in-overview-1"
description: "How the Opensense Outlook Add-in for Microsoft 365 works: the three deployment methods compared, requirements, key considerations, and every add-in article."
updated: 2026-08-21T14:39:00.000Z
canonical: "https://help.opensense.com/docs/outlook-add-in-overview-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.opensense.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook Add-in overview

## Overview

The Opensense Outlook Add-in is a centrally managed Microsoft 365 Integrated App that automatically applies your company's email signatures to every email composed in Outlook, on desktop, web, and mobile. Your IT team deploys and manages it, and end users don't need to do anything.

This article is for IT admins who configure or manage the add-in. It explains how the add-in works, the deployment methods and their tradeoffs, and links to all the articles in this section.

:::tip[End users]
To learn what the add-in does and how to use it on mobile, go to [End user experience](#end-user-experience).
:::

:::caution[GCC High compatibility]
The Opensense Outlook Add-in is compatible with [Microsoft 365 GCC High environments](https://www.opensense.com/gcc-high-email-signatures). Opensense connects to the Azure Government cloud infrastructure built for GCC High, so user data is sourced directly from your GCC High Azure AD tenant. Additional configuration is required. See [Opensense Outlook Add-in integration with GCC High environments](https://help.opensense.com/docs/opensense-add-in-integration-with-gcc-high-environments).
:::

## How it works

Once deployed, the add-in loads automatically when a user opens a new compose window in Outlook, and inserts their assigned signature. How that signature is handled depends on your deployment method:

<dl class="kb-insights-summary">
  <div><dt>Client-side</dt><dd>The signature is sent directly with the email from Outlook.</dd></div>
  <div><dt>Server-side stamping</dt><dd>The signature is cleared from the compose window before the email is sent, and Opensense's servers apply the signature during routing.</dd></div>
</dl>

The add-in is deployed through [Microsoft 365's Centralized Deployment](https://learn.microsoft.com/en-us/microsoft-365/admin/manage/centralized-deployment-faq?view=o365-worldwide). Your admin assigns users or groups in the Microsoft 365 admin center, and the add-in installs silently across Outlook desktop, Outlook on the web (OWA), and Outlook Mobile.

## Deployment methods

The add-in supports three deployment methods. The right choice depends on how much compose-window visibility your employees need, and how much server-side control your organization needs for compliance and marketing.

<ul class="kb-test-methods" role="list">
  <li>
    <span class="kb-test-methods__label">Server-side, after send</span>
    <strong>Stamping</strong>
    <p>Signatures are applied entirely server-side after send. Nothing is inserted into compose.</p>
    <ul>
      <li>The add-in pane shows a preview of what recipients will receive</li>
    </ul>
  </li>
  <li>
    <span class="kb-test-methods__label">Recommended</span>
    <strong>Plain Text Block</strong>
    <p>The add-in inserts a token into compose. A mail flow rule routes the email to Opensense for server-side transformation.</p>
    <ul>
      <li>The add-in pane shows a preview of what recipients will receive</li>
      <li>Opensense's patented approach, recommended for most deployments</li>
    </ul>
  </li>
  <li>
    <span class="kb-test-methods__label">Client-side, in compose</span>
    <strong>Visual Preview</strong>
    <p>The full HTML signature is rendered client-side in the compose window.</p>
    <ul>
      <li>Users can see and edit it before sending</li>
    </ul>
  </li>
</ul>

![Two Outlook compose windows side by side: on the left, a Plain Text Block with the [[#]] trigger, name, title, and mobile; on the right, the fully rendered Visual Preview signature with logo, contact details, and a disclaimer](https://help.opensense.com/media/ptpvsvisual-c31687a1e91f.png)

### Comparing the methods

<div class="kb-deployment-compare kb-deployment-compare--plain">
  <div class="kb-deployment-compare__viewport" role="region" aria-label="Outlook Add-in deployment methods compared" tabindex="0">
    <table>
      <colgroup><col class="kb-deployment-compare__feature-col"></colgroup>
      <thead>
        <tr>
          <th scope="col">Feature</th>
          <th scope="col"><a class="kb-deployment-compare__method" href="#server-side-stamping-with-add-in-signature-removal">Stamping</a></th>
          <th scope="col"><a class="kb-deployment-compare__method" href="#plain-text-block-patented">Plain Text Block</a></th>
          <th scope="col"><a class="kb-deployment-compare__method" href="#visual-preview">Visual Preview</a></th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th scope="row">Compliance</th>
          <td>Signatures are applied entirely server-side. Users cannot modify them.</td>
          <td>The final signature is applied server-side by Opensense. Users cannot modify the rendered output.</td>
          <td>Users can edit the signature (content, formatting, layout) before sending. Those edits bypass Opensense servers entirely, and are not tracked or blocked. This is a meaningful compliance risk for organizations with signature governance requirements.</td>
        </tr>
        <tr>
          <th scope="row">Marketing</th>
          <td>Full recipient-based banner targeting and advanced analytics.</td>
          <td>Full recipient-based banner targeting and advanced analytics.</td>
          <td>Sender-based banner targeting only; recipient-based targeting is not supported. Analytics are limited to basic views and clicks.</td>
        </tr>
        <tr>
          <th scope="row">End user experience</th>
          <td>No signature visible while composing. Employees need to understand this is expected behavior before launch.</td>
          <td>A plain text trigger where the signature will render, plus a built-in preview of the HTML that is non-clickable and non-editable.</td>
          <td>A fully rendered HTML signature that users see and interact with while composing.</td>
        </tr>
        <tr>
          <th scope="row">Best for</th>
          <td>Organizations that require strict signature control and can explain the compose-window experience to employees clearly.</td>
          <td>Organizations that want server-side compliance and the full marketing feature set, while giving employees visible confirmation that their signature is active.</td>
          <td>Organizations where compose-window visibility is a priority, and the compliance risk and marketing limits are acceptable tradeoffs.</td>
        </tr>
      </tbody>
    </table>
  </div>
</div>

For each method's strengths and limitations, and help choosing one, see [Comparing Outlook Add-in deployment methods](https://help.opensense.com/docs/deployment-mode-comparison).


### Server-side stamping with add-in signature removal

The add-in removes any locally saved Outlook signatures before the email is sent. No signature is visible in the compose window. The email routes through Opensense's servers after send, where the correct HTML signature and any marketing banners are applied before delivery.


### Plain Text Block (patented)

The add-in inserts a tokenized plain text block containing Opensense's proprietary `[[#]]` trigger into the compose window, alongside a non-clickable visual preview of the final rendered signature. When the email is sent, a mail flow rule detects the `[[#]]` token and routes the message to Opensense, where it is transformed server-side into the full HTML signature before delivery.

:::note[The best of both]
The Plain Text Block bridges the gap between Stamping and Visual Preview: employees see that their signature will be applied, while the actual signature stays under server-side control.
:::


### Visual Preview

The add-in renders a live HTML signature directly inside the Outlook compose window. The signature is inserted client-side before the email is sent.

:::caution[Visual Preview and compliance]
If your organization uses email signatures for legal disclaimers, regulatory compliance, or brand governance, review the tradeoffs carefully before you choose this method. See [Outlook Add-in Visual Preview capabilities and tradeoffs](https://help.opensense.com/docs/outlook-add-in-visual-preview-capabilities-and-tradeoffs).
:::

## System requirements

The add-in needs Exchange Online, a supported Microsoft 365 or Office 365 license, and an Outlook client that meets the minimum version for Centralized Deployment. MSI-based installs and volume-licensed Office versions (Office 2016, 2019, and 2021) are not supported, because they don't support the required API version.

For the full version table, platform support matrix, and unsupported environments, see [Outlook Add-in supported environments](https://help.opensense.com/docs/supported-environments-for-the-opensense-outlook-add-in).

## Key deployment considerations

<dl class="kb-insights-summary">
  <div><dt id="propagation-time">Propagation time</dt><dd>After a user or group is added to the add-in's deployment scope in Microsoft 365, it can take up to 72 hours for the add-in to appear in Outlook. Plan your rollout timeline for this, and add test users first to gauge propagation speed in your environment.</dd></div>
  <div><dt id="admin-consent">Admin consent</dt><dd>End users are prompted to accept permissions when the add-in deploys, unless an admin grants consent in advance. To avoid prompts that disrupt employees, grant admin consent in Azure Active Directory before launch. See <a href="https://help.opensense.com/docs/clone-outlook-add-in-scope-users-for-opensense-in-m365-admin#step-3-regrant-admin-consent-for-enterprise-applications">Scoping Outlook Add-in users in the Microsoft 365 admin center</a>.</dd></div>
  <div><dt id="nested-groups-are-not-supported">Nested groups are not supported</dt><dd>Microsoft does not support nested groups for Centralized Deployment. Users must be directly assigned to a top-level Microsoft 365 group. If your group structure uses sub-groups, add the users to a top-level group manually.</dd></div>
  <div><dt id="third-party-email-platforms">Third-party email platforms</dt><dd>The add-in only applies signatures to emails composed in Microsoft Outlook. Emails sent through third-party platforms such as Outreach, Salesloft, or Salesforce are not covered. For those platforms, use Opensense's routed mail flow integrations.</dd></div>
  <div><dt id="outlook-mobile-from-switching-limitation">Outlook Mobile From switching</dt><dd>On Outlook Mobile, the add-in passes only the primary account context to the API. If a user switches the <strong>From</strong> address to an alias or shared inbox, the add-in does not update the signature for the switched identity. This is a Microsoft platform limitation, and it applies to all deployment methods.</dd></div>
</dl>

## End user experience

For most employees, the add-in needs no setup or action. Once your IT admin deploys it, the signature appears automatically when you compose a new email in Outlook. The add-in replaces or removes locally saved Outlook signatures.

Depending on your organization's configuration, you see one of these:

- A plain text block in the compose window, with a non-clickable preview of your formatted signature
- A fully rendered HTML signature in the compose window (Visual Preview)
- No visible signature in the compose window, with the signature applied automatically after send (Stamping)

:::caution[Incorrect information in your signature?]
Contact your IT helpdesk or the team that manages your Opensense account.
:::

To use the add-in on your mobile device, see [Using the Opensense Outlook Add-in on iOS](https://help.opensense.com/docs/how-to-access-opensense-outlook-add-in-on-ios) or [Using the Opensense Outlook Add-in on Android](https://help.opensense.com/docs/how-to-access-opensense-outlook-add-in-on-android).

## Article directory

All Outlook Add-in documentation, by topic. If you're setting up the add-in for the first time, start with **Requirements and deployment**.

### Requirements and deployment

<ul class="kb-link-cards kb-link-cards--two" role="list">
  <li><a href="https://help.opensense.com/docs/supported-environments-for-the-opensense-outlook-add-in"><span><strong>Outlook Add-in supported environments</strong><span>Minimum version requirements, and supported and unsupported platforms.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/clone-outlook-add-in-scope-users-for-opensense-in-m365-admin"><span><strong>Scoping Outlook Add-in users in the Microsoft 365 admin center</strong><span>Deploy the add-in and manage user scope in Microsoft 365.</span></span></a></li>
</ul>

### Configuration

<ul class="kb-link-cards kb-link-cards--two" role="list">
  <li><a href="https://help.opensense.com/docs/clone-outlook-add-in-domain-settings-with-scenarios-and-best-practices"><span><strong>Configuring the Outlook Add-in in Domain Settings</strong><span>Signature insertion settings, alias and shared inbox behavior, editable fields, and inline images.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/clone-outlook-add-in-multi-signature-selector"><span><strong>Setting up multiple signatures in the Outlook Add-in</strong><span>Turn on and set up multiple signatures per user.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/custom-compose-fields"><span><strong>Setting up Custom Compose Fields for the Outlook Add-in</strong><span>Dropdown, checkbox, and free-text fields in the compose pane. Not compatible with Stamping.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/clone-outlook-add-in-routed-key-behaviors-and-nuances"><span><strong>Expected behaviors in routed Outlook Add-in deployments</strong><span>Edge cases for Stamping with field edits, shared account permissions, domain switching, and manual manifest installation.</span></span></a></li>
</ul>

### Visual Preview

<ul class="kb-link-cards kb-link-cards--two" role="list">
  <li><a href="https://help.opensense.com/docs/outlook-add-in-visual-preview-capabilities-and-tradeoffs"><span><strong>Outlook Add-in Visual Preview capabilities and tradeoffs</strong><span>What Visual Preview supports, compliance risks, marketing limits, and when it makes sense.</span></span></a></li>
</ul>

### GCC and GCC High environments

<ul class="kb-link-cards kb-link-cards--two" role="list">
  <li><a href="https://help.opensense.com/docs/opensense-add-in-integration-with-gcc-high-environments"><span><strong>Opensense Outlook Add-in integration with GCC High environments</strong><span>Custom manifest deployment, directory sync requirements, and mobile configuration for GCC High.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/using-the-outlook-mobile-add-in-within-gcc-environments"><span><strong>Outlook mobile add-ins in GCC and GCC High environments</strong><span>Turn on mobile add-ins in GCC environments, where they are off by default.</span></span></a></li>
</ul>

### Troubleshooting and offboarding

<ul class="kb-link-cards kb-link-cards--two" role="list">
  <li><a href="https://help.opensense.com/docs/outlook-add-in-troubleshooting-guide-2"><span><strong>Troubleshooting the Outlook Add-in</strong><span>Missing add-in, permission issues, signature not applying, cache clearing, and debugging.</span></span></a></li>
  <li><a href="https://help.opensense.com/docs/how-to-remove-the-opensense-add-in-from-m365-admin"><span><strong>Removing the Outlook Add-in in the Microsoft 365 admin center</strong><span>Remove users, or the add-in, from Microsoft 365.</span></span></a></li>
</ul>


## What's next

- [How does Opensense work with Microsoft 365?](https://help.opensense.com/docs/how-does-opensense-work-with-office-365)
- [Outlook Add-in launch guide](https://help.opensense.com/docs/opensense-outlook-add-in-launch-guide-everything-you-need-to-know)
