Auto Light Dark
Auto Light Dark

Using OneApproval in Word

With the OneApproval Word add-in, you can request, review and manage approvals from a task pane next to your document.

Your Microsoft 365 admin needs to have deployed the add-in. See Install the Word add-in.

Save your document to the cloud

OneApproval only works with Word documents saved to a cloud location, such as OneDrive or SharePoint. If you open the OneApproval task pane on a document saved only on your computer, you'll see a warning asking you to save it to the cloud before you can start an approval.

Open the OneApproval task pane

  1. Open a Word document saved to OneDrive or SharePoint.

  2. Select OneApproval on the Home tab of the ribbon to open the task pane. In Word on the web, it may be under the … (more options) menu.

  3. Sign in with your OneApproval account if prompted.

Request approval

The flow is the same as in Confluence, with one extra step: because Word documents don't belong to a site, you choose which OneApproval organisation to use.

  1. In the task pane, select Quick approval.

  2. Choose the Organisation to create the approval in.

  3. Optionally, enter a Title. If you leave it blank, the request is called "Document Approval".

  4. Optionally, add Additional information for your approvers.

  5. Choose your approvers:

    • Registered approvers: Search for people in the selected organisation.

    • Invite by email: Enter the email address of anyone else.

  6. Select Submit approval request.

Approvers are notified by email, and the task pane shows the approval as Pending .

Approvers need access to the Word document, for example through OneDrive or SharePoint sharing. OneApproval doesn't change document permissions.

Review a document

  1. Open the document and the OneApproval task pane.

  2. Review the document.

  3. Optionally, add a comment.

  4. Choose Approve, Approve with changes, Request changes or Reject.

The task pane shows your decision, the overall status and the date. You can change your decision while the approval is still in progress.

Resubmit or cancel a request

  • Resubmit: Select Resubmit, optionally change the approvers and confirm. All decisions reset and the status returns to Pending . The requester can resubmit at any stage, and once an approval is concluded, anyone can resubmit it.

  • Cancel: As the requester, select Cancel request and confirm. The approval is removed from the document.

View the approval history

Select History in the task pane. This opens the approval in the web app, where you can see every request, decision and status change with timestamps, and export it as a CSV file. See Approval history.

Limitations in early access

  • Quick approval only: one round, no templates.

  • Untitled requests use "Document Approval" as the title. Using the document's own title is planned.

  • Approval status isn't yet shown inside the document itself. This is coming at launch.

  • Editing the document after it's approved doesn't change the approval. Expire on edit for Word is being investigated, and we aim to include it at launch.