Auto Light Dark
Auto Light Dark

How approvals work

This page explains the core ideas behind OneApproval. They apply the same way in Confluence, Word and the web app.

Accounts

You have one OneApproval account, tied to your email address. You can sign in with an email link, Microsoft, Google or Atlassian. As long as the email address is the same, you always reach the same account, whichever surface or sign-in method you use.

Organisations

Everything in OneApproval lives inside an organisation: approvals, members and platform connections. Your account can belong to several organisations, and you can switch between them in the web app. When you request an approval, it's created in one organisation, and only that organisation's members can be chosen as registered approvers.

  • In Confluence: Each Confluence site is connected to one organisation, so approvals created on that site always belong to it.

  • In Word: You choose the organisation each time you request an approval.

  • In the web app: Approvals are created in the organisation you currently have selected.

Who's involved

Role

What they do

Requester

Starts the approval, chooses the approvers, and can cancel or resubmit the request

Approver

Reviews the document and makes a decision, with an optional comment

You can be both. For example, you can add yourself as an approver on your own request.

Approval types

In early access, every approval is a Quick approval: a single round, with no template. You choose who should approve and send it. Templates and multi-round approvals are coming at launch.

Choosing approvers

  • Registered approvers: People who are already members of your organisation. Search for them by name or email.

  • Invite by email: Anyone else, including people outside your company. They're invited to your organisation and asked to review in the same step.

Minimum required approvers

By default, every approver must approve before the request is approved.

When you request approval from the web app, you can lower this by setting the minimum required approvers. For example, with three approvers you might only need two to approve. Requests made in Confluence and Word always need every approver for now.

Whatever the minimum, a single Request changes or Reject ends the approval.

Decisions

Approvers choose one of four decisions and can add an optional comment.

Decision

Type

What it means

Approve

Positive

The document is good to go.

Approve with changes

Positive

Good to go, with small, non-blocking suggestions.

Request changes

Negative

The document needs changes before it can be approved.

Reject

Negative

The document isn't approved.

  • Positive decisions count towards the minimum: Both Approve and Approve with changes count towards the minimum required approvers.

  • One negative decision ends the approval: A single Request changes or Reject concludes the request straight away.

  • You can change your mind: Approvers can change their decision at any time while the approval is still in progress.

Statuses

The overall status shows where an approval is up to. You'll see it in the Confluence byline, the Word task pane and the web app.

Status

When it applies

Pending

The request has been sent and no one has decided yet.

In progress

At least one approver has decided, but the minimum hasn't been reached yet.

Approved

Enough approvers have approved, and none chose Approve with changes.

Approved with changes

Enough approvers have approved, and at least one chose Approve with changes.

Requires changes

An approver has requested changes.

Rejected

An approver has rejected the document.

When decisions differ, the overall status is the least affirmative one. For example, one Approve and one Approve with changes gives Approved with changes, and one Request changes and one Reject gives Rejected.

Resubmitting and cancelling

You can resubmit and cancel from Confluence, Word or the web app.

  • Resubmit: The requester can resubmit at any stage, including while an approval is still in progress. Once an approval is concluded, any user can resubmit it. Resubmitting resets every decision, sets the status back to Pending and lets you change the approvers. This is the usual next step after changes are requested.

  • Cancel: The requester can cancel a request. It's removed from the document, which goes back to having no current approval.

Editing a document after approval

In early access, editing a document doesn't change its approval. Expire on edit, which flags an approval as no longer valid when the document changes, is coming at launch for Confluence. For Word, we're investigating it and aim to include it at launch too.

History

Every request, decision, resubmission and status change is recorded with a timestamp, and each decision is recorded against the version of the document it applies to. See Approval history.

Seeing documents in the web app

OneApproval doesn't copy your Confluence pages or Word documents. It stores a reference and fetches details such as the title and link as you, using your connected account. That means you only ever see content you already have permission to see. It also means you need to connect your Confluence and Microsoft accounts to see document details and make decisions in the web app. At launch, you'll be able to see document titles and links without connecting your account. See Sign in and connect your accounts.