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.