> For the complete documentation index, see [llms.txt](https://docs.tiny.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tiny.plus/guides/integrations/outlook-add-in.md).

# The Outlook Add-in

Install the tiny+ Outlook Add-in, sign in, and use it to see who's emailing you, save emails and attachments, and add contacts and tasks from your inbox.

The tiny+ Outlook Add-in opens a pane beside the email you're reading and shows what tiny+ knows about the person who sent it: their details, who in your firm looks after them, and what was said last. From the same pane you can save the email and its attachments against a contact, company or project, add a contact who isn't in tiny+ yet, give someone a task, and post to the contact's news feed, all without leaving Outlook.

It's free, and you sign in with your usual tiny+ login.

{% hint style="info" %}
The add-in is separate from the [contacts and calendar sync](https://docs.tiny.plus/guides/integrations/contacts-and-calendar-sync.md). You can use either, or both.
{% endhint %}

## Prerequisites

1. A Microsoft 365 (Exchange Online) mailbox or an Outlook.com account. The add-in runs in Outlook on the web, the new Outlook for Windows and Mac, and classic Outlook for Windows and Mac when they're connected to one of these.
2. Saving attachments needs a recent Outlook. The rest of the add-in works in older versions; the save form tells you if attachments will be left behind.
3. In some organisations, add-ins are installed by the Microsoft 365 administrator rather than by each person. If you can't find **Get add-ins**, see [For administrators](#for-administrators) below.

## Installing

The add-in is published on Microsoft AppSource. Either:

* Open [**tiny+ on Microsoft AppSource**](https://appsource.microsoft.com/en-us/product/office/WA104382022?src=office\&tab=Overview) and click **Get it now**, then sign in with your Microsoft account; or
* In Outlook, open an email and choose **Get add-ins** (under the **...** menu on the message, or **Apps** in the ribbon), search for *tiny+*, and click **Add**.

The AppSource page is also linked from **Our apps**, under the help menu at the top right of tiny+.

Once installed, open any message and click **Apps** in the toolbar: **tiny+** is listed there, and clicking it opens the pane beside the message. In classic Outlook the **tiny+** button sits in the ribbon instead.

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-3ae916a0a908cd79707e9d35bcc599d648969b08%2Foutlook-addin-button.png?alt=media" alt="An open message in Outlook on the web, with the Apps menu open and tiny+ listed in it" width="1000"><figcaption></figcaption></figure>

{% hint style="success" %}
Pin the pane (the pin icon at its top) and it stays open as you move from message to message, loading the right contact each time.
{% endhint %}

## Signing in

The first time you open the pane it asks you to connect Outlook to tiny+. Click **Sign in to tiny+**. A window opens with the usual tiny+ sign-in: your email and password, your two-factor code if you have [two-factor authentication](https://docs.tiny.plus/guides/how-tos/enabling-two-factor-authentication.md) on, or your organisation's [single sign-on](https://docs.tiny.plus/guides/advanced/single-sign-on-azure.md). Then confirm that the Outlook Add-in may use your account.

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-58f742dedcc625f633e054c458f60f239ddbde98%2Foutlook-addin-signin.png?alt=media" alt="The pane before signing in: the tiny+ logo, Connect Outlook to tiny+, and the Sign in to tiny+ button" width="400"><figcaption></figcaption></figure>

You stay signed in across Outlook sessions. To sign out, click the sign-out icon at the top right of the pane. Don't have a tiny+ account yet? **Sign up for tiny+** under the button takes you to the registration page.

### More than one account

If your login belongs to more than one tiny+ account, the account you're working in is shown under your name at the top of the pane. Click it to switch. The pane remembers your choice for this mailbox.

## Who's emailing you

Open an email and the pane works out who it's about: the sender and everyone in the To line, leaving out you and your colleagues. Then:

* **One person**, and they're a tiny+ contact: their contact card loads.
* **One person**, not in tiny+ yet: the pane offers to [add them](#adding-a-contact), with their name and email already filled in.
* **Several people**: the pane lists them, and you choose which one to load.
* **Only colleagues**, or nobody at all: the pane says so, and you can still [save the email](#saving-an-email).
* **An email sent by tiny+**, such as a notification or a mail-out, opens the record it's about.

## The contact card

The card is the contact as tiny+ has them: name and title, their company, and their email and phone numbers, which you can click to call or write. Beside the name, the pencil opens a quick edit and the arrow opens the full record in tiny+.

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-5c8ea993e3898822800d0d92b8cb0146eacaa03c%2Foutlook-addin-contact.png?alt=media" alt="A contact card in the pane: Mike Smith, Director at ABC Pty Ltd, his mobile number, his team, the Save email and Add task buttons, and the news feed below with a recent post" width="400"><figcaption></figcaption></figure>

Below the details are the faces of the contact's **team**, the people in your firm who look after them. If you're not one of them, **Join Team** adds you, so the contact's activity reaches your [news feed](https://docs.tiny.plus/guides/everyday/news-feed.md) and your dashboard.

Then come the two actions, **Save email** and **Add task**, and under those the contact's **News Feed**.

### Quick edit

Click the pencil beside the name to change the contact's name, title, company, mobile, direct line or office phone, and press **Save to tiny+**. For anything else, open the full record in tiny+.

### The news feed

The bottom of the card is the contact's feed from tiny+: who posted what, and when. Read it to catch up before you reply. To post, type in **Share your news here** and click **Share**. Your post appears on the contact's page in tiny+ and in the news feed for anyone following them.

## Saving an email

Click **Save email** on a contact card, or below the pane's message when no contact loaded, to file the email in tiny+ where the whole team can see it.

Choose what the email relates to:

* **Related contacts**: the loaded contact is already ticked. Search to add others.
* **Related companies** and **Related projects**: the contact's own companies and projects are listed as tick boxes. Search for any others.

At least one contact, company or project is needed. The form tells you how many attachments will be saved along with the email; small inline images, like the logos in email signatures, are left out.

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-05a95fbb4e3e2e7628b465e8abaf9a2febd0e629%2Foutlook-addin-save-email.png?alt=media" alt="The Save email form: the contact ticked under Related contacts, ABC Pty Ltd ticked under Related companies, a project chosen under Related projects, and the Save email button" width="400"><figcaption></figcaption></figure>

Press **Save email**. The pane shows **Email saved in tiny+**, and shows it again whenever you come back to that message, so nothing is filed twice.

Saved emails appear on the contact's **Emails** tab, in the **Emails** panel on the related company and project pages if your admin has switched it on, and in [search](https://docs.tiny.plus/guides/everyday/search.md). The contact's feed gets a post that you shared an email. See [Filing emails by BCC](https://docs.tiny.plus/guides/integrations/inbound-emails.md) for where filed emails live and the admin switches.

Saving an email also counts as being in touch with each contact it's saved against. [Connect](https://docs.tiny.plus/guides/everyday/connect.md) and [Contact Coverage](https://docs.tiny.plus/guides/reports/built-in-reports.md#contact-coverage) then show them as last in touch by an email, on the day you saved it.

{% hint style="warning" %}
A saved email can be read by everyone on the account. Don't save anything the whole firm shouldn't see.
{% endhint %}

## Adding a contact

When the person emailing you isn't in tiny+, the pane opens **Add new contact** with their name and email filled in from the message. Add their title, company and phone numbers if you have them, and press **Add to tiny+**. The contact is assigned to you, and their card loads straight away.

## Adding a task

Click **Add task** on a contact card to give yourself, or a colleague, something to do about the email: call back, send the proposal, follow up next month. Type the details, choose who it's assigned to (you, unless you change it) and a due date, and press **Add task**. The task is related to the contact and shows up on the assignee's dashboard, like any other [task](https://docs.tiny.plus/guides/everyday/meetings-and-tasks.md).

<figure><img src="https://1957838173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LnoXYnzHXoSKmkXmIHw%2Fuploads%2Fgit-blob-b11b9a96ca0ca0ceabd4d965e0c44ac9c0dfe1b4%2Foutlook-addin-add-task.png?alt=media" alt="The Add new task form: Details filled in, Assigned To and Due Date" width="400"><figcaption></figcaption></figure>

## For administrators

To put the add-in in everyone's Outlook at once, deploy it from the Microsoft 365 admin center: **Settings -> Integrated apps -> Get apps**, search for *tiny+*, and choose which users or groups get it. It appears in their Outlook within a day or so, and updates to the add-in reach them automatically.

The add-in talks only to *outlook.tiny.plus*, *api.tiny.plus* and *login.tiny.plus*. It reads the message that's open in Outlook, and writes nothing to the mailbox. Each person signs in with their own tiny+ login and sees exactly what they could see in tiny+: confidential records, roles and permissions apply as they do on the web.

## Troubleshooting

* **The tiny+ button isn't there.** Add-ins only appear while a message is open for reading, not while you're writing one. If **Get add-ins** is missing from Outlook, your administrator controls add-ins; ask them to deploy it.
* **The sign-in window doesn't open.** Allow pop-ups from *outlook.tiny.plus* and try again. In classic Outlook, check that you're signed in to Outlook with your Microsoft 365 account.
* **"No CRM contacts found."** Nobody on the email, other than you and your colleagues, is a tiny+ contact, and there's no single address to offer. Forward the email to yourself, or save it against a company or project instead.
* **Attachments weren't saved.** Your Outlook is too old to hand attachments to add-ins. Update Outlook, or save the email from Outlook on the web.
* **Signed out unexpectedly.** Your tiny+ session has ended, for instance after a password change. Click **Sign in to tiny+** again.

Stuck? [Contact us](https://crm.tiny.plus/help) from the app, or email <support@tiny.plus>.
