Notes to read before you begin
- A VisibleThread Public Cloud account with access to the MS Word Add-in page (Method B & C only)
- A Microsoft 365 admin role that allows you to deploy Integrated apps (Method A only)
- Method B & C do not support Mac. Use Method A for Mac users.
Choose a deployment method
| Method | Use when | You need |
|---|---|---|
| A. Microsoft 365 admin center | Recommended. Get the add-in from Microsoft AppSource and assign it to users. No manifest file needed. | Microsoft 365 admin access |
| B. SharePoint app catalog | You already distribute add-ins through an app catalog. | App catalog access and the manifest file |
| C. Windows network share | Your organization doesn't use Microsoft 365 or SharePoint. Windows only. | A network folder with Read access and the manifest file |
Complete one method only.
Method A: Microsoft 365 admin center
Admin steps
- Go to Microsoft AppSource and search for VisibleThread.
- Open the listing and click Get it now.
- Sign in with your Microsoft 365 admin account. You are redirected to the Microsoft 365 admin center, on the Integrated apps page.
- Click Assign users and choose Just me, Entire organization, or Specific users or groups.
- Review the requested permissions and finish the deployment.
Send the following steps to the users
Users will see the add-in after restarting Word, usually within a few hours (or up to 24 hours).
- In Word, go to Insert > My Add-ins.
- Open Admin Managed.
- Select VisibleThread, click Add, then sign in to the panel.
Method B: SharePoint app catalog
Step 1: Download the manifest file
- In VisibleThread (https://app.visiblethread.com), go to Settings > MS Word Add-in.
- Click Download Manifest File and save manifest.xml.
Step 2: Open SharePoint
- Open your SharePoint app catalog site and the Apps for Office library.
- Upload manifest.xml.
- Confirm the add-in is available to the users who need it.
Step 3: Send the following steps to the users
- In Word, go to Insert > My Add-ins.
- Open Admin Managed.
- Select VisibleThread, click Add, then sign in to the panel.
Method C: Windows network share
Step 1: Download the manifest file
- In VisibleThread (https://app.visiblethread.com), go to Settings > MS Word Add-in.
- Click Download Manifest File and save manifest.xml.
Step 2: Set up the share
- Create a network folder your users have Read access to and copy manifest.xml into it.
- Send users the UNC path, for example
\\fileserver\visiblethread.
Note: Word reads the manifest each time the add-in starts. If the folder is behind a firewall, users must be on the corporate network or VPN.
Step 3: Send the following steps to the users
- Go to File > Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs.
- Enter the UNC path in Catalog Url, click Add catalog, select Show in Menu, then click OK.
- Restart Word.
- Go to Home > Add-ins > Advanced. Open Shared Folder, select VisibleThread, click Add, then sign in to the panel.
Note: In older versions of Word, the same dialog opens from Insert > My Add-ins.
Note: If a future version of the add-in changes the Word ribbon, users on this method will need to add the add-in again.
Troubleshooting
| Issue | What to check |
|---|---|
| Add-in missing in Word | Restart Word. Confirm the user is in the assignment you selected and allow up to 24 hours after deployment. |
| Manifest rejected on upload | Confirm the file is the unmodified manifest.xml from VisibleThread. Download it again if unsure. |
| Shared Folder tab is empty | Check the UNC path, that Show in Menu is selected, and that the user has Read access. |
| User cannot sign in | Confirm the user has an active VisibleThread account. |