Skip to main content

O365 Add-in

JUMP DIRECTLY TO DEPLOYMENT INSTRUCTIONS

To import people into Dynasend before deployment (Entra, Google directory, or CSV), see Importing people.

O365 Add-in Overview​

email signature add-in scan results

Seamless User Experience / Centralized Deployment

  • Multi-platform compatibility: Outlook Web, Outlook Desktop - Windows, Outlook for Mac (running the modern UI), Outlook Mobile App (iOS).
  • Safe to use - won't crash Office: Unlike previous VSTO and COM add-ins, our new modern add-in runs in a sandbox within the Office application. As a result, it cannot cause Outlook itself to crash.
  • No performance loss: Our add-in will not slow down the launching speed of Outlook.
  • Centrally deployed and updated: Our add-in is deployed using the centralized deployment feature offered by Office 365. Learn more.

email signature add-in

This is a UI-less / event-driven add-in. What does that mean? It means that the add-in interprets events occuring within Outlook, and responds automatically - the user sees nothing new, does nothing new - but the desired result still occurs:

  • recognize a new message being opened - add the user's corporate signature
  • recognize a reply message being composed - add the user's corporate reply signature
  • recognize that the user has Outlook set to use a non-approved signature - override it with the approved signature
  • recognize that all message recipients are "internal" - apply a slimmed-down internal signature (planned; contact support for availability)

Our web-based Outlook add-in is easily deployed remotely to users by the O365 administrator. The technology is agentless, meaning that there are no COM or EXE modules that need to be installed on the client side. It's a modern web-add-in pushed directly to user accounts in Office 365. As a result, there's no download, no configuration, and no security risk.

Centralized Deployment​

Our add-in is easily deployed via the Microsoft O365 admin center.

Additional Information

O365-deployment-email signature add-in

An alternative deployment approach is to use the Centralized Deployment PowerShell cmdlets to manage add-ins.

Outlook Mobile App Integration​

email signatures for iOS and Android

Our service is fully integrated into the Outlook Mobile App for both iOS and Android, subject to these three limitations:

  • mobile add-in cannot distinguish replies from new messages - the "new message" signature will always be used
  • mobile add-in cannot distinguish "internal" messages - the "new message" signature will always be used
  • the Dynasend taskpane is not available in mobile - editing the signature will need to be occur from the user's computer

We understand that in most cases employees will be using their personal phones. Our service runs entirely in the cloud, integrated with the O365 subscription they are already connected to, meaning that nothing actually gets installed on user's phones.

Add-in Deployment Instructions - O365 Administrators​

Here are the supported email clients.

Here's a Microsoft support article that provides considerations when assigning an add-in to specific users or groups.

Deployment will immediately impact users

Note: Please DO NOT do this unless you have been directed to do so by Dynasend personnel. Deployment of the add-in prior to Dynasend provisioning your account will create unnecessary complications. Thank you.

Visit your Office 365 Integrated Apps portal.

o365-email-signature-add-in-deployment-instructions-1

Click Upload custom apps.

o365-email-signature-add-in-deployment-instructions-2

Choose App type to be Office Add-in.

Copy this URL:

https://outlook-add-in.dynasend.net/manifest.xml

and paste it into the manifest file URL field. After pasting, click Validate and then Next.

To finish, Assign users and then click Deploy (screen-capture not shown). After deploying, you can close this window.

Deployment takes up to 24 hours

Note: It will probably take about 24 hours before the add-in appears in Outlook.

When the add-in becomes active, users will be prompted from within Outlook to complete their signature profile.

Add-in FAQ's​

1. I have a user who's signature is not working for Windows Outlook Desktop version - what can I do?​

The most likely cause of the problem: In mid-2024 Microsoft dropped their support of Internet Explorer (as a background runtime engine for some Office applications) resulting in the email signature O365 add-in not working in a small number of cases. This problem can only be resolved by installing Microsoft's WebView2 Runtime (this has been a part of Windows updates since April of 2021, but some users have failed to install it). These articles discuss the product and provide the installation links:

Overview - Microsoft Edge WebView2 and Microsoft 365 Apps

Installation - Microsoft Edge WebView2


2. A user is getting an "Invalid state" error during logon - what should I do?​

Open your browser's history and clear "active logins". After clearing active logins you should be able to logon to Dynasend without receiving this "invalid state" error.


3. The Outlook Add-in is loading blank screen - what should I do?​

If you're on a Windows machine and running the Outlook Add-in in the Outlook Desktop app, you might encounter a blank screen when trying to load the Add-in.

If this happens, here are some things you can check:

Possible Problem #1 - Internet Explorer 11

Dynasend does not support Internet Explorer 11, and Microsoft will no longer support this browser beginning in August, 2021. To fix this issue, you’ll need to install WebKit2 from Microsoft. This will update your runtime environment to use Edge instead of Internet Explorer 11.

Possible Problem #2 - Script is being blocked

The Outlook Add-in might also be loading blank because of a script being blocked.

To resolve this, follow the steps outlined below:

  • Select the Windows button > search for “Tools” and select “Internet options.”
  • Once the window opens, select the “Security” tab and then select “Internet.”
  • On that page, select “Custom level” and scroll down to the “Scripting” section. Select “Enable” under “Active Scripting.”
  • Click “OK” to close that window.
  • Click “OK” to close the Internet Options window.
  • Run the Add-in to test and see if the issue continues.

For more information on this issue, visit Understanding the Office Add-ins runtime.


4. Users see an ADD-IN ERROR saying,"The content is blocked" - what should I do?​

dynasend content is blocked

The content on the Taskpane is served from https://outlook-add-in.dynasend.net/ - the problem may be that your network is blocking access to non-whitelisted domains. The solution then is to whitelist dynasend.net

Note: Despite the appearance of this error, we do ALWAYS MAINTAIN A VALID SECURITY CERTIFICATE (unexpired) that is handled by AWS.


5. After deploying the add-in to our Citrix environment it's not showing up in Outlook - what could be wrong?​

Check to see if you have a group policy in AD that's preventing the plugin from working.

Also, Citrix environments are often firewalled - make sure *.dynasend.net (or manage.dynasend.net and cdn.dynasend.net) are whitelisted.


6. A user's signature suddenly stopped working - what should I do?​

The problem usually relates to the desktop version of Outlook - repairing and/or updating Outlook is typically the solution.

REPAIR OUTLOOK: In most cases this can be resolved by running the "repair utility" on Office / Outlook. Microsoft's instructions are available here.

UPDATE OUTLOOK: If the repair utility doesn't solve the problem, make sure that you are using the most current version of Outlook. Here's how to check, and then update if necessary:

how to update Office 365 Outlook

ADDITIONAL RESOURCES FOR IT PROFESSIONALS: If neither of these help, here are a couple of other resources published by Microsoft:


7. A user's signature usually appears, but sometimes it doesn't. What might cause this?​

1.) If you are replying to a message that was composed in "plain text" format, Dynasend will apply the plain-text version of your signature. This will be missing all graphics / colors, and so it may appear as if it is not working. However, this is how Outlook is designed to work.

2.) If you are suffering from a very slow internet connection, your signature simply may not appear. Outlook has to retrieve the signature in order for you to compose your message. If this retrieval process is taking too long, Outlook will just skip the signature so that you can get on with composing your email. This is by design - a Microsoft "best practice".


8. How can I set the signature's behavior for shared mailboxes?​

The Dynasend taskpane allows you to set the signature's behavior for shared mailboxes:

setting the signature for shared mailboxes

Note: For non-shared mailboxes, either setting is fine as they both will accomplish the same result.


9. Does Dynasend support Microsoft 365 Group mailboxes?​

No. Dynasend does not support Microsoft 365 Group mailboxes (group mailboxes). This is a Microsoft Outlook platform limitation, not a Dynasend product limitation: Outlook does not activate web add-ins (including Dynasend) when the current item is in a Group mailbox.

See Microsoft's documentation on Outlook add-in activation limitations.

Dynasend does support user mailboxes and shared mailboxes. Microsoft documents Group mailboxes separately from shared mailboxes; enabling shared-mailbox support does not extend to Groups.

If you need Dynasend signatures for a shared address, use a shared mailbox rather than a Microsoft 365 Group mailbox.


10. When using a "Delayed Send Rule" and the signature gets duplicated when users re-open unsent messages. How do I fix this?​

Currently the only solution to this problem is to manually delete the duplicate signatures before sending.

We are aware of this problem and are investigating potential solutions. (Note: a fix is not promised at this time.)


11. How can I tell if the Mac version of Outlook is "Classic" or the "Modern UI"?​

classic vs modern UI for Outlook Mac

Here's more from Microsoft about the new Outlook UI for Mac.


12. How does our data, and our Outlook, interact with Dynasend?​

Our application is hosted on AWS and leverages Auth0 for authentication.

Within our application, we capture the user's email, which triggers the generation of the email signature. Both the email address and metadata necessary for rendering the signature (title, phone, full name, etc.) are stored in our system.

Once the Outlook add-in is installed, each new email composition, or change in email recipients, prompts a request to our server for the most up-to-date version of the signature. Although signatures are cached and delivered via a CDN, we execute a rapid query to a dedicated endpoint on our server that redirects to the CDN. This ensures that users always receive the most current version of their signature.

In the event of a failure to fetch the signature, the add-in degrades gracefully, allowing email composition to proceed without a signature.


13. What smartphones & tablets are supported?​

Here's a Microsoft article with specific details about mobile & tablet support.


14. How do users enable the Dynasend add-in on their iPhones?​

Navigate to Settings > Add-ins > and then tap the "+" icon

activate the add-in on iphone_instructions


15. How do I update the Dynasend manifest?​

On occasion we release a version that requires us to make changes to our manifest.xml file. In this case, for you to take advantage of the features in the release you will need to update the Dynasend manifest.

To access this upgrade, your Microsoft O365 administrator will need to update the Dynasend Integrated App (in the O365 admin portal) to the new URL:

To make this upgrade, navigate to: Office 365 admin center > Settings > Integrated apps > Dynasend app

The following two graphics illustrate.

Integrated Apps 1

Integrated Apps 2


16. What email clients are supported?​

Our O365 add-in requires "Mailbox version 1.5" (or higher) - here's a link to Microsoft's current documentation on Outlook JavaScript API requirement sets.

Following is Microsoft's chart (modified by us) to show the Outlook / O365 clients we currently support.

email signature add-in supported email clients

Additional Requirements​

Users must also have Exchange Online and active Exchange Online mailboxes. Your subscription directory must either be in or federated to Microsoft Entra ID.

How to Check Your Outlook Version​

To check the channel/version of your Outlook desktop in Windows, go to File > Office Account. The current channel is displayed in the About Outlook section.

To view the Outlook version in macOS, click the About Outlook icon. The version details are displayed at the top of the popup.

Add-in Troubleshooting​

Outlook Problems

In the vast majority of cases it is our experience that problems with the add-in relate to Outlook problems, and they resolve themselves (without you doing anything) in two or three days.

[Temporary workaround is available]

Your current signature can be manually installed to serve as a temporary workaround while Micorsoft fixes your Outlook problem. Here are the temporary installation instructions

The problem usually relates to the desktop version of Outlook, and in almost all cases, just waiting (patiently) for a few days ends up being the solution (it seems that Microsoft does a silent update or repair and the problem resolves itself). If this is not the case, or if you cannot wait, repairing and/or updating Outlook may solve the problem more quickly.


Close and Restart Outlook​

By closing Outlook and restarting it you will ensure that it has all the most current add-in's loaded. This is the first, and easiest, thing to try.


Repair Outlook​

In most cases this can be resolved by running the "repair utility" on Office / Outlook. Microsoft's instructions are available here.


Update Outlook​

If the repair utility doesn't solve the problem, make sure that you are using the most current version of Outlook. Here's how to check, and then update if necessary:

how to update Office 365 Outlook


Contact Us for Help​

If neither of the two above steps resolve the problem, please email us here and provide us with the following three pieces of information:

  1. Tell us what problem you're experiencing so we will know what we're trying to help you resolve.

  2. Login to your web version of Outlook and see if the signature is working properly from there? Let us know if your signature is working properly there.

  3. Take a screen-capture of your version of desktop Outlook. You can find this by first clicking "FILE" in the upper left corner of your inbox:

how to update Office 365 Outlook

Then click "OFFICE ACCOUNT" and screen-capture the page that is displayed:

how to update Office 365 Outlook

Create and Install a Temporary Signature for Outlook Desktop​

[This serves as a stopgap solution if the dynasend add-in is not functioning]

Following is an approach to manually installing your current Dynasend signature into desktop Outlook and setting it as your default so that you still have a signature while you wait for Microsoft to fix the problem with your Outlook.

First you will need to log in here (use the "one time password" option).

When you reach the Dynasend user profile, click the "Send Signature" button:

Email with signature sent to recipient

You will then receive an email - click the "View Signature HTML" button:

Instructions email with signature setup steps

Your signature will open in your browser. Press Ctrl-A and then Ctrl-C (this will copy your signature to your clipboard).

Copy signature content to clipboard

Now go to your Outlook Desktop's inbox and navigate as shown below:

Outlook menus for signature options

Create a new signature and give it a name:

Outlook create new signature dialog

Paste in the signature you previously copied, set it as your default, and click "OK"

Paste signature and save in Outlook

This process will set your Dynasend signature up as your default and it will function for you until Microsoft repairs your Outlook and your signature begins functioning normally for you again.

[Temporary signature is not dynamic]

This manually installed signature is static, and will not update automatically, it is intended to function as a stopgap for a brief time until the Dynasend add-in begins running properly in your Outlook.

[Later removal is not necessary]

Once the Dynasend add-in begins to function again, this signature will be automatically overridden, so there is no need to worry about removing it later.

Outlook Mobile App Add-in (iOS & Android)​

We have updated our O365 add-in to run on the Outlook Mobile App (iOS and Android).

Note the following limitations:

  • The mobile add-in cannot distinguish replies from new messages — the "new message" signature will always be used.
  • The mobile add-in cannot distinguish "internal" messages — the "new message" signature will always be used.
  • The Dynasend task pane is not available in mobile — editing the signature will need to occur from the user's computer.

Upgrade process​

Nothing will be installed on your users' phones

Prior to the update, the add-in has already been running (in the cloud) on your users' phones; it just hasn't been working. If you make this update, the add-in will begin working on their phones (just as it currently does on their desktop and web versions of Outlook). This will only change the signature behavior on the business email account on their phones.

This version required us to make changes to our manifest file. To access this upgrade, your Microsoft O365 administrator will need to update the Dynasend Integrated App (in the O365 admin portal) to the new URL:

To make this upgrade, navigate to: Office 365 admin center > Settings > Integrated apps > Dynasend app

Integrated Apps update step 1

Integrated Apps update step 2