Skip to content
  • There are no suggestions because the search field is empty.

How to install the Qrtr Add-in

 

What this involves

Qrtr's fixing workflow happens inside Microsoft Word, through an add-in. Before anyone in your firm can use it, someone with Microsoft 365 administrator access has to deploy that add-in to your tenant. It is a one-off task, it takes a few minutes, and it is done entirely in Microsoft's admin center rather than in Qrtr.

This article is for whoever holds that access. If you are a Qrtr user waiting for the add-in to appear in Word, this is the page to send to your IT team.

Before you start

You need to be able to reach the Integrated apps portal in the Microsoft 365 admin center, and not every administrator role can. Access is limited to Global Admins, AI admins, Azure Application Admins and Exchange admins. If Integrated apps is not visible to you under Settings, this is almost certainly why, and the answer is to find a colleague who holds one of those roles rather than to keep looking.

You will also need the Qrtr manifest address, which is:

https://app.qrtr.ai/addin/manifest.xml

That address does not change between customers. There is nothing to download and nothing specific to your organisation to obtain from us first.

Installing the add-in

  1. Open the Microsoft 365 admin center for your organisation.
  2. In the sidebar, choose Integrated apps under Settings. You may need to select Show all first to reveal the Settings menu.
  3. Select Upload custom apps.
  4. Choose Office Add-in as the app type.
  5. Choose Provide link to manifest file, and enter the manifest address above.
  6. Select Validate, then Next.
  7. Assign the users and groups who should have the add-in, and review the permissions it requires.
  8. Select Finish deployment.

At step 7, think about who actually needs it. The add-in is where authors fix issues, so anyone who writes or revises documents that go through Qrtr needs it. Reviewers and approvers who only work in the browser do not, although there is no harm in giving it to them.

What happens next

Once deployment finishes, the Qrtr add-in appears as a button in the Home toolbar in Microsoft Word for the users you assigned it to.

It will not appear immediately. Microsoft propagates add-in changes across a tenant on its own schedule, and this can take up to 24 hours — for additions, removals and changes to who has access alike. Nothing has gone wrong if a user cannot see the button an hour after you finish. Tell people to expect it the next working day, and you will avoid a round of support requests on the afternoon you deploy.

Changing or removing it later

The same Integrated apps page is where you manage the add-in after deployment. From there an administrator can change which users and groups have access, turn the add-in off without removing it, or delete it altogether. The same propagation delay applies to all of these, so a user may still see the button for a while after you have removed their access.

If it does not work

You cannot find Integrated apps under Settings. Select Show all in the sidebar first. If it is still not there, your administrator role does not include access to that portal — see *Before you start* above.

Validation of the manifest fails. Check the address is exactly as written above, with no trailing characters. If it still fails, the likely cause is a network policy in your organisation blocking the request rather than a problem with the manifest itself.

Users still cannot see the button after 24 hours. Confirm they were included in the assignment at step 7, and that they are opening the desktop or web version of Word rather than a different application. If the assignment is right and time has passed, contact us.

The button appears but the add-in will not load. This is usually a sign-in issue rather than a deployment one. Article 10 covers opening the add-in and signing in.

Microsoft's own documentation

If you get stuck at a step that is part of Microsoft's interface rather than ours, Microsoft's guidance is more current than anything we can restate here.