Recipient Finder Support
Getting Started
How to Install
Individual Installation
-
Visit Microsoft AppSource
- Search for "Recipient Finder"
- Click "Get it now" and authorize permissions for your account
- The add-in appears in your Outlook ribbon
Admin-led Installation (Recommended for Organisations)
For the smoothest rollout, an IT Admin should perform the initial installation:
- Open Outlook and find Recipient Finder in the add-in store or install from AppSource
- When prompted, check "Consent on behalf of your organization"
- The add-in is now available to all users in your Microsoft 365 tenant — no individual setup required
Individual installation (without admin): Users can install directly from the
Outlook add-in store and grant permissions for their own account only.
If your organisation requires admin approval, you'll see a message prompting you to contact IT.
First-Time Setup
When you first open Recipient Finder:
-
Sign in with Microsoft — We'll ask for permission to
index your mailbox
-
Start 30-day trial — Full access, no credit card needed
-
Wait for indexing — Takes 30–60 seconds to index your
inbox
-
Start searching! — Type any name or email to find
contacts
Supported Platforms
- ✅ Outlook on the Web (all major browsers)
- ✅ Outlook for Windows (Microsoft 365)
- ✅ Outlook for Mac (Microsoft 365)
- ❌ Outlook Mobile (not currently supported)
- ❌ Standalone Outlook 2016/2019 (not supported)
How to Use
Finding Recipients
- Compose a new email in Outlook
- Open the Recipient Finder panel (click the add-in button)
- Type a name or email address in the search box
- Click the "To", "Cc", or "Bcc" button to add the recipient
How Search Works
Recipient Finder searches through everyone who has
sent you an email. It matches against:
- Email addresses (e.g., "john@company.com")
- Display names (e.g., "John Smith")
- Company domains (e.g., "company.com")
Note: Only senders from your inbox are indexed — not
everyone you've ever emailed.
Refreshing Your Index
The add-in automatically checks for new senders periodically. To force a
refresh:
- Open Recipient Finder settings (⚙️ icon)
- Click "Refresh Index"
- Wait 10–30 seconds for the indexing to complete
Frequently Asked Questions
Does it read my email content?
No. Recipient Finder only reads the "From" field (sender
email and name). It never accesses email subjects, bodies, or attachments.
Where is my data stored?
All contact data is stored
locally on your device (browser storage). Nothing is sent
to our servers except your license status. See our
Privacy Policy for details.
Can I use it with shared mailboxes?
Currently, Recipient Finder only works with your personal mailbox. Shared
mailbox support may be added in a future update.
What happens after the trial?
The trial is per organisation (Microsoft 365 tenant) — not per individual
user. After 30 days, your organisation will need to purchase a license from
Microsoft AppSource to
continue using the add-in. Individual reinstalls do not restart an
organisation's trial once it has been used. Your indexed contacts will be
preserved.
How do I cancel my subscription?
-
Go to
Microsoft Account Services
- Find "Recipient Finder" under Subscriptions
- Click "Manage" → "Cancel"
You'll retain access until the end of your billing period.
The add-in takes a long time to load on first open
The add-in may take up to 30–45 seconds to load the very first time after
a long period of inactivity. This is normal — our license server runs in a
low-cost serverless mode and wakes up on first use. Subsequent opens are
instant.
🔧 Troubleshooting
The add-in isn't showing up
Try these steps:
- Refresh your browser (Web) or restart Outlook (Desktop)
-
Check if it's enabled:
File → Manage Add-ins → Recipient Finder
(should be checked)
- Clear your browser cache (Web) or Office cache (Desktop)
- Uninstall and reinstall from AppSource
Sign-in keeps failing
If you get repeated sign-in errors:
- Clear your browser cookies and cache
- Make sure you're using a Microsoft 365 account (not Outlook.com)
-
Check if your organisation requires admin consent — contact your IT
department
- Try using Outlook on the Web in a different browser
If your organisation just purchased a license and you're
still seeing a trial or unlicensed screen, click
"Already purchased? Check license" in the add-in. This
forces an immediate license check without waiting for the cache to refresh.
No results when searching
Common causes:
-
First-time indexing not complete — Wait 60 seconds and
try again
-
Empty inbox — You need received emails to build the
index
-
Spelling — Try searching by email address instead of
name
-
Stale index — Go to settings and click "Refresh Index"
Add-in is slow or unresponsive
- Check your internet connection
- Try closing and reopening the add-in panel
- Clear browser cache
-
If the problem persists, contact us with your Outlook version and
platform
I accidentally cleared my data
Data can be recovered! Simply click "Refresh Index" in settings. The
add-in will re-scan your mailbox and rebuild the contact list (takes 30–60
seconds).
Privacy & Security
Is my data secure?
Yes. All contact data is stored locally on your device using your
browser's secure storage. It never leaves your computer. See our
Privacy Policy for details.
What permissions do you need?
Recipient Finder requests:
-
Mail.Read — To read sender information from your inbox
- User.Read — To identify your Microsoft account
-
Standard sign-in permissions — To authenticate you
securely
All permissions are "Delegated" (only work when you're signed in). We have
no background access to your mailbox.
Note on the "may send data to third parties" warning:
Microsoft automatically displays this notice for any add-in with compose
window access. Recipient Finder does not send your email
content to our servers or any third party. See our
Privacy Policy §3 for the full explanation.
Can I delete my data?
Yes, anytime:
- Local data: Click "Clear All Data" in settings
-
Server data (license only): Email us to request
deletion
Last Updated: March 19, 2026