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

# How To Download Affinity's Outlook Add-in

> Help center reference

<Note>
  **How-to** — task-oriented recipe.
</Note>

With the Affinity for Outlook add-in, Microsoft users can now take Affinity-related actions straight from their Outlook web and desktop apps. Check out this article to ensure you have the prerequisites and understand how to troubleshoot common issues in case you cannot access the add-in.

## Who can access Affinity's Outlook Add-in?

| Essentials | Scale | Advanced | Enterprise |
| ---------- | ----- | -------- | ---------- |
| No         | Yes   | Yes      | Yes        |

Interested in upgrading to **Scale**, **Advanced**, or **Enterprise**? Please reach out to your Affinity point of contact or [support@affinity.co](mailto:support@affinity.co).

## Prerequisites

* Affinity's Outlook add-in is only available for Office 365 and Exchange (On-Prem) accounts.
* Affinity's Outlook add-in is only compatible for Outlook versions after Outlook 2016.
* Affinity's Outlook add-in is only supported on the following browsers: **Google Chrome, Microsoft Edge,** and **Safari**.

## How to download Affinity for Outlook Add-in (Web App)

In addition to [Microsoft's article on Outlook add-ins](https://support.microsoft.com/en-us/office/use-add-ins-in-outlook-1ee261f9-49bf-4ba6-b3e2-2ba7bcab64c8), you can follow the steps below:

1. If you're an **Affinity CRM user**, feel free to skip Step 2 below and move on to Step 3.
2. If you're an **Affinity for Salesforce user**, please make sure your Salesforce Admin selects which users are allowed access to the Affinity for Outlook add-in (see the section titled "How to assign the Affinity permission set to users" in the article [How to install/update Affinity's Managed Package in Salesforce](/s/article/How-to-install-update-Affinity-s-Managed-Package-in-Salesforce)).
3. Now, make sure to sign in to your Outlook account that has specific access to your Affinity instance. Open any email, then click the **ellipsis (3-dotted icon)**. Click **Get Add-ins**.
   <img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-1.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=954d69e8c61649afbf5d3f7b8829221d" alt="Outlookdl 1" title="Outlookdl 1" style={{ width:"56%" }} width="1416" height="1172" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-1.jpeg" />
4. Search for **Affinity for Outlook**.
   <img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-2.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=0f4c4e7a1b4ee51e7805f8a99477252d" alt="Outlookdl 2" width="1882" height="434" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-2.jpeg" />
5. Click **Add.**
   <img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-3.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=e2d0816cb50c7c114189f17a7c217752" alt="Outlookdl 3" title="Outlookdl 3" style={{ width:"80%" }} width="1858" height="692" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-3.jpeg" />
6. Click open any email, then click the 3 dots to see **Affinity for Outlook** appear.
   <img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-4.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=d39ce31dfc1629213795f3c8af5fac7f" alt="Outlookdl 4" title="Outlookdl 4" style={{ width:"81%" }} width="3262" height="1552" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-4.jpeg" />
7. Once you've successfully downloaded the add-in, check out one of the following based on whether you're using the Affinity CRM or Affinity for Salesforce:
   1. [Affinity CRM - How to use Affinity's Outlook Add-in](/s/article/Affinity-CRM-How-to-use-Affinity-s-Outlook-Add-in)
   2. [Affinity for Salesforce - How to use Affinity's Outlook add-in](/s/article/Affinity-for-Salesforce-How-to-use-Affinity-s-Outlook-add-in)

## How to download Affinity for Outlook Add-in (Desktop App)

In addition to [Microsoft's article on Outlook add-ins](https://support.microsoft.com/en-us/office/use-add-ins-in-outlook-1ee261f9-49bf-4ba6-b3e2-2ba7bcab64c8), you can follow the steps below:

1. If you're an **Affinity CRM user**, feel free to skip Step 2 below and move on to Step 3.
2. If you're an **Affinity for Salesforce user**, please make sure your Salesforce Admin selects which users are allowed access to the Affinity for Outlook add-in (see the section titled "How to assign the Affinity permission set to users" in the article [How to install/update Affinity's Managed Package in Salesforce](/s/article/How-to-install-update-Affinity-s-Managed-Package-in-Salesforce)).
3. Now, open your Outlook desktop application to access your add-ins:
   1. **Windows users**: Click the **Files** tab at the very top of your screen, then click **Manage Add-ins**.
   2. **Mac users**: Click the **Tools** tab at the very top of your screen, then click **Get Add-ins**.

<img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-5.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=88f5d34bb79f65d60b06e2bcf88f7ea7" alt="Outlookdl 5" title="Outlookdl 5" style={{ width:"83%" }} width="690" height="240" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-5.jpeg" />

4. Search for **Affinity for Outlook**, then download the add-in.

<img src="https://mintcdn.com/support-affinity/UsAWZFcV3RiHqsHx/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-6.jpeg?fit=max&auto=format&n=UsAWZFcV3RiHqsHx&q=85&s=6126069d8768f2347ee71c3a75161891" alt="Outlookdl 6" width="1840" height="400" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-6.jpeg" />

5. Once you've successfully downloaded the add-in, check out one of the following based on whether you're using the Affinity CRM or Affinity for Salesforce:
   1. [Affinity CRM - How to use Affinity's Outlook Add-in](/s/article/Affinity-CRM-How-to-use-Affinity-s-Outlook-Add-in)
   2. [Affinity for Salesforce - How to use Affinity's Outlook add-in](/s/article/Affinity-for-Salesforce-How-to-use-Affinity-s-Outlook-add-in)

## Troubleshooting Common Issues

### Problem: Blank Screen? Clear your cache

If met with a blank screen (see example below), you will need to empty your cache and perform a hard reload of the application. The reload will help to retrieve the latest version of the Outlook add-in.

<img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-7.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=4a8adfde18a15e869b36dad49046997b" alt="Outlookdl 7" width="1528" height="720" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-7.jpeg" />

To reload, please follow steps below based on which browser/app you're using.

### Web App — Clearing your cache

**Google Chrome**

1. Windows users — Press **Ctrl** + **F5** on your keyboard.
2. Mac users — Press **Cmd** + **Shift** + **R** on your keyboard.

**Firefox**

1. Windows users — Press **Ctrl** + **F5** on your keyboard.
2. Mac users — Press **Cmd** + **Shift** + **R** on your keyboard.

**Safari**

1. Click **Safari** on the top navigation bar, then click **Empty Cache**, or press **Opt** + **Cmd** + **E**.
2. To refresh, click the **Refresh** button on the address bar or press **Cmd** + **R**.

**Microsoft Edge**

1. Press **Ctrl** + **F5** on your keyboard.

### Desktop App — Clearing your cache

**Outlook Desktop for Mac**

1. Open Affinity for Outlook add-in.
2. Right click the side panel.
3. Select **Reload**.

<img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-8.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=5a619143ebdc6f174395cc987a7d6e8d" alt="Outlookdl 8" width="2200" height="718" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-8.jpeg" />

**Outlook Desktop for Windows**

1. Open the **Affinity for Outlook** add-in.
2. Right click the side panel.
3. Select **Refresh**.

<img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-9.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=e3f8df80bfa7fc8d1142f8612903f25b" alt="Outlookdl 9" title="Outlookdl 9" style={{ width:"80%" }} width="1668" height="1128" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-9.jpeg" />

### Problem: Missing or Disabled add-in icon?

### Web App — Checking your cookie settings

1. On the top-right corner of your web browser, click the **ellipsis (3-dotted icon)**, then click **Settings**.
   <img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-10.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=f05e38574935df7463d2db960f196dd8" alt="Outlookdl 10" title="Outlookdl 10" style={{ width:"45%" }} width="754" height="948" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-10.jpeg" />

2) Click **Privacy and security**, then click **Cookies and other site data**.
   <img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-11.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=5123ef2a930e1040878626c79f40ea4a" alt="Outlookdl 11" title="Outlookdl 11" style={{ width:"71%" }} width="2066" height="876" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-11.jpeg" />

3. Make sure your cookie settings are either **Allow all cookies** or **Block third-party cookies in Incognito**. If they are set to **Block third-party cookies** or **Block all cookies (not recommended)**, then Affinity's Outlook add-in will not work.
   <img src="https://mintcdn.com/support-affinity/4b8LMNecUYooL8LF/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-12.jpeg?fit=max&auto=format&n=4b8LMNecUYooL8LF&q=85&s=9fab663261877c09a1016513b93f8b81" alt="Outlookdl 12" width="1346" height="762" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-12.jpeg" />

### Desktop App — Missing or Disabled Add-in icon (for Windows/PC)

1. Click **File** to open additional options.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-13.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=19a220f27572ab655da1d09f1735579c" alt="Outlookdl 13" title="Outlookdl 13" style={{ width:"86%" }} width="2723" height="1742" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-13.jpeg" />

2) Select **Office Account**, and select **Manage Settings**.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-14.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=f8e4db55dda21b323b14089491449147" alt="Outlookdl 14" title="Outlookdl 14" style={{ width:"56%" }} width="1218" height="1116" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-14.jpeg" />

3. Check the box for **Enable optional connected experiences**, then click **OK** and restart Outlook.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-15.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=16c387674a1ae4647d48e61cada84524" alt="Outlookdl 15" title="Outlookdl 15" style={{ width:"60%" }} width="1562" height="1303" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-15.jpeg" />

4) If you still do not see the add-in appear after restarting, open your Office Options menu and go to **File** > **Options**.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-16.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=651e2c8170908e280df9d99878f10bf5" alt="Outlookdl 16" title="Outlookdl 16" style={{ width:"86%" }} width="2782" height="1770" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-16.jpeg" />

5. Select **Customize Ribbon (1)**, then select **All Commands (2)**. Then, click **Add-ins (3)** and click **Add>> (4)** to add the Add-ins icon to your Ribbon (menu bar).
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-17.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=ad5d357c0428f5cb66a095db5ba16b39" alt="Outlookdl 17" title="Outlookdl 17" style={{ width:"67%" }} width="1673" height="1371" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-17.jpeg" />

6) Click **OK** to save your changes.

### Desktop App — Missing or Disabled Add-in icon (for Mac)

1. Click **Outlook** on the top left corner, then click **Preferences**.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-18.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=2bfced299c379a60dc61d170a7de558c" alt="Outlookdl 18" title="Outlookdl 18" style={{ width:"69%" }} width="2114" height="1524" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-18.jpeg" />

2) Click on **Privacy**.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-19.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=39c4455c43df4f8cb4b692f61b93c098" alt="Outlookdl 19" title="Outlookdl 19" style={{ width:"79%" }} width="1533" height="754" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-19.jpeg" />

3. Click **Manage Connected Experiences**.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-20.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=1ba6be99875da4a89b3d0277bab17d92" alt="Outlookdl 20" title="Outlookdl 20" style={{ width:"66%" }} width="1204" height="1314" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-20.jpeg" />

4) Ensure **all checkboxes** are enabled, then click **OK**. You may need to restart Outlook to apply these changes.
   <img src="https://mintcdn.com/support-affinity/WsikfPPgde7HiUKH/images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-21.jpeg?fit=max&auto=format&n=WsikfPPgde7HiUKH&q=85&s=5eefbae621a68a4035011ea4a430496a" alt="Outlookdl 21" width="910" height="1000" data-path="images/integrations-outlook/how-to-download-affinity-outlook-addin/outlookdl-21.jpeg" />

**Note:** Some users may have to ask their IT team for permission to use Affinity's Outlook Add-in. See [Specify the administrators and users who can install and manage add-ins for Outlook](https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/add-ins-for-outlook/specify-who-can-install-and-manage-add-ins) to learn more.
