Notes to read before you begin
- A VisibleThread GovCloud account with access to the MS Word Add-in page
- A Microsoft 365 admin role that allows you to deploy Integrated apps (Method A only)
- Methods B and 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. Upload the manifest file and assign the add-in to users centrally. | Microsoft 365 admin access and the manifest file |
| 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
Step 1: Download the manifest file
- Sign in to VisibleThread at your organization's GovCloud address, then go to Settings > MS Word Add-in.
- Click Download Manifest File and save manifest.xml.
Step 2: Upload the add-in
- Sign in to the Microsoft 365 admin center. For GCC High, go to https://portal.office365.us/adminportal/home.
- Go to Settings > Integrated apps.
- Click Upload custom apps.
- In App type, select Office Add-in, select Upload manifest file (.xml) from device, then click Choose File and select manifest.xml.
- On the Users step, choose Just me, Entire organization, or Specific users or groups.
- On the Deployment step, review the details and finish the deployment.
- Confirm VT Add-In is listed under Deployed apps with status OK.
Step 3: Send the following steps to the users
Users see the add-in after restarting Word, usually within a few hours (or up to 24 hours).
- In Word, go to Home > Add-ins (or Insert > My Add-ins).
- Open Admin Managed.
- Select VT Add-In, click Add, then sign in to the panel.
Method B: SharePoint app catalog
Step 1: Download the manifest file
- Sign in to VisibleThread at your organization's GovCloud address, then 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.
Note: Do not use Upload on the SharePoint admin center Manage apps page. It adds the file to Apps for SharePoint, where it shows as Disabled and Word cannot use it. Reach Apps for Office from the app catalog site's Site contents, or click classic experience on the Manage apps page.
- Upload manifest.xml.
- Confirm the add-in is listed as VT Add-In and is available to the users who need it.
Step 3: Send the following steps to the users
- In Word, go to File > Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs.
- Enter the app catalog site address in Catalog Url, for example
https://contoso.sharepoint.us/sites/appcatalog, click Add catalog, select Show in Menu, then click OK. - Restart Word.
- Go to Home > Add-ins > Advanced, select VT Add-In, click Add, then sign in to the panel.
Note: Add-ins from a SharePoint app catalog do not show a button on the Word ribbon, and Word shows "This Add-in uses features not supported by its add-in catalog." The add-in works normally; users open it from Home > Add-ins. Use Method A if users need the ribbon button.
Method C: Windows network share
Step 1: Download the manifest file
- Sign in to VisibleThread at your organization's GovCloud address, then 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. |
| Add-ins dialog shows "Please add or enable add-in catalogs from the Trust Center" (Method B) | Word has no catalog registered. Add the app catalog site address under Trusted Add-in Catalogs, select Show in Menu, and restart Word. |
| Manifest shows as Disabled in SharePoint (Method B) | The file was uploaded to Apps for SharePoint. Delete it there and upload it to the Apps for Office library. |
| 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 account on the GovCloud site the manifest was downloaded from. |