# Installation guide

## Step-by-step guide

{% stepper %}
{% step %}

### Go to the integration tab

In the signature tab select the Microsoft 365 option then click on "**Install Scribe add-in".** in the right panel.&#x20;

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2Fb4stRo8ObtZjciXCPJHX%2FScreenshot%202025-02-02%20at%2013.29.27.png?alt=media&#x26;token=e4e6a2ef-2e67-4088-90a3-5f370cdd5efe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### In the Microsoft App source marketplace click on "Get it now"

Click on the button below and install the Scribe Add-in from [Microsoft App Source](https://appsource.microsoft.com/en-US/product/office/WA200004057).&#x20;

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FUClC2aGJyysVp3DhT7s8%2FScreenshot%202024-04-23%20at%2020.24.37.png?alt=media&#x26;token=bb1c197c-68e0-438f-8c04-d5db9ab92a80" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Select the correct account

You will be redirected to the Addin installation in your Microsoft 365 admin.If you are redirected to your Outlook Inbox, you are not connected as a global administrator. In that case, the add-in will not work properly.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FroRDlUyzUZ4RSSaJfIof%2Fimage.png?alt=media&#x26;token=9d6b31f6-1dc4-45bc-9863-3ecb21c5688d" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://app.scribe-mail.com/static/media/microsoft-365-2.e5dd6864f6aad6248c52.png" alt="" width="375"><figcaption><p>`</p></figcaption></figure>
{% endstep %}

{% step %}

### Select "Entire organization"

Choose the users for whom you want to deploy the add-in then click Next. We advise you to select "Entire organization" except if you want to test on a small batch of users first.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FE4Q2MLD4XtRUcdVgQhYr%2Fimage.png?alt=media&#x26;token=2c553564-8259-4ac2-9e17-482dc0d468dc" alt=""><figcaption></figcaption></figure>

<figure><img src="https://app.scribe-mail.com/static/media/microsoft-365-3.cd0aadcd8dd9e2572271.png" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Accept permissions

Click on Accept permissions and accept the permissions in the opened popup.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FPzhgfupzFBWTKLZka5Nd%2Fimage.png?alt=media&#x26;token=4b32c2ce-2b74-45ec-ada4-436404a43129" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click on Finish deployment

The add-in will now be deployed in your O365 account and across all the Outlook of your users. Note: According to Microsoft, it can take up to six hours for the app to appear in Outlook. In practice, it's less than 30 minutes.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FOV30WlRqhcN4dwxledUD%2Fimage.png?alt=media&#x26;token=3e4b86ae-73cf-44d9-b3e3-9ff29d9d7050" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Wait for Microsoft installation validation

**Microsoft is deploying the Scribe Add-in across your team's Outlook accounts.**\
**This process can take up to 72 hours.** Activate template installation and your teammates' signatures will be installed when Microsoft deployment completes. You will be notified by email when the add-in is installed.
{% endstep %}

{% step %}

### Go to your signature template then click on the "Activate template installation" button

Once template installation is activated, all teammates assigned to your templates will automatically have their signatures installed in Gmail. 🎉

You can install signatures across all templates or individually with one click. Whenever you modify a template, your Scribe email signatures will automatically update.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FQeHfL7WLpwduxW4eWs8O%2FScreenshot%202025-02-02%20at%2011.51.33.png?alt=media&#x26;token=fa5325b8-564d-4694-bb45-1c7ead8efd24" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Troubleshooting

If the Scribe add-in isn't validated within 72 hours by Microsoft check the following

### **The correct Microsoft account is selected**

"Make sure you select the Microsoft account you want to use with Scribe. Users sometimes accidentally choose accounts from different domains. You can verify this in [Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200004057).

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FoZ43dArg3yE5P5KO1gZ3%2Fimage.png?alt=media&#x26;token=c1825a12-fda7-4576-819a-6c40433f7d86" alt=""><figcaption></figcaption></figure>

### **The correct email is selected**

Make sure the email **<gil@scribemailtest.onmicrosoft.com>** is part of your Microsoft account.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FFFq9BYoUOdAshX1vEjtZ%2Fimage.png?alt=media&#x26;token=b4b2d82f-735b-4085-99ff-0b0b7e2f1ef4" alt=""><figcaption></figcaption></figure>

### **You have selected "entire organization"**

Make sure to select the option **"entire organization"** when installing the app.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FZA4y7bzqc3geEN3ow2pb%2Fimage.png?alt=media&#x26;token=5734a1d2-1da1-451f-a378-f04898f64b12" alt=""><figcaption></figcaption></figure>

### **The add-in is installed as an integrated app**

Ensure the Scribe Add-in is installed as an **integrated app** in the [Microsoft 365 admin center](https://admin.microsoft.com/Adminportal/Home#/Settings/IntegratedApps), not just in your Outlook account. Ask your IT department if necessary.

<figure><img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FnYqIF6F4yqmTfPRRXm9U%2Fimage.png?alt=media&#x26;token=4a3d6306-748d-424b-a174-6eabdb2e8404" alt=""><figcaption></figcaption></figure>

### Check your Outlook compatibility below.

The user requires an active Microsoft 365 subscription that includes Outlook Desktop. The Scribe Outlook add-in is compatible with the following Outlook versions:

<details>

<summary><strong>On Windows</strong></summary>

Have at least version 2403 (Build 17425.20000) or New Outlook

**Where to find your Office 365 update channel?**&#x20;

In Outlook desktop, click on File → Office Account. In the "About Outlook" section, you'll see your update channel.

<img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FKNtPI1RAzBzzhZd89kDv%2Fwindows-11-2022-05-02-11-24-35_8o6t4o.png?alt=media&#x26;token=9e90440f-2007-4a67-85dd-0321f205e35e" alt="" data-size="original">

**Where to find the version of your Outlook on Windows?**

In Outlook desktop, navigate to File → Office Account → About Outlook. A window will open displaying your Outlook version.

<img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FDriZ1DTOqg1wXIjj8WZ8%2Fwindows-11-2022-05-02-11-26-20_1beohuo.png?alt=media&#x26;token=fc759bd9-7955-46cf-a859-3ba3a82e156c" alt="" data-size="original">

</details>

<details>

<summary>On MacOS</summary>

The Outlook add-in is compatible only with the new version of Outlook for Mac V16.54 (21101001) and later versions.

**How to activate the new version of Outlook for Mac?**

Activate the new Outlook version using the toggle at the top right. Click on "Open the new Outlook", and Outlook will restart using the new version.

<img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2FVRKyp3BNCQjOhP1zDftB%2Finbox-gilscribemailtestonmicro_7vr4ha.png?alt=media&#x26;token=6ae4e8bc-6956-406a-b517-f8be16fff368" alt="" data-size="original">

**How to determine the version of your Outlook for Mac?**&#x20;

Click on the Outlook menu at the top left, then select "About Outlook"

<img src="https://208817895-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdCWalfiZW3LFy32wvLxI%2Fuploads%2F5HkyjBISznwQW3UAnMcw%2Fabout-outlook-2022-05-02-11-38_174jszi.png?alt=media&#x26;token=690987a4-9ece-4efe-a540-13bc7cdc11d3" alt="" data-size="original">

</details>

## Note

{% hint style="warning" %}
You have to be connected as a Microsoft 365 Global Administrator to install the Scribe Outlook Add-in.
{% endhint %}

{% hint style="warning" %}
This integration works for Microsoft 365 users with licenses, not personal Outlook accounts.
{% endhint %}

{% hint style="info" %}
This integration will install your Scribe signature on the Microsoft 365 PC and Apple desktop apps, as well as on the Microsoft 365 web version.
{% endhint %}

{% hint style="info" %}
For an automated installation, Scribe ensures 24/7 brand consistency. This is achieved by Scribe continuously comparing teammates' signatures to the approved Scribe design. If discrepancies are detected, Scribe automatically triggers a reinstallation of the correct signature design.
{% endhint %}

{% hint style="info" %}
When you move a teammate in your Microsoft Entra ID to another group it automatically moves it to the appropriate Scribe department.
{% endhint %}

{% hint style="info" %}
When you deactivate a license for a user in your email provider, the user's signature will be removed from Scribe as well as from your subscription.
{% endhint %}

{% hint style="info" %}
Rest assured, [Scribe is SOC2 Type II compliant](https://scribe.trust.page/), ensuring the safety of your data.
{% endhint %}
