Approval lets your organisation, or one team, check a plugin's changes before they reach members. This page is for the Admins who switch it on, the people who publish, and the approvers who decide.
## How approval works
A plugin needs approval when your organisation requires it, or when the team that owns the plugin does. Publishing it then means requesting approval:
- The request freezes the plugin as it was saved, and you can keep editing.
- An approver compares the frozen copy with the live version, then approves it, which publishes it as the next version, or declines it with a reason.
- Editing, sharing, switching a plugin off, and changes to members, teams and settings never wait for approval.
## Turn on approval
### 1. Choose where it applies
- **For the whole organisation:** an organisation Admin goes to Settings › Organisation › General and, under **Approval**, switches on **Require approval**. Every plugin needs approval, each team's included, and no team can switch it off.
- **For one team:** a team Admin, or an organisation Admin, opens the team in Settings › Organisation › Teams and, under **Team settings**, switches on **Require approval**. It covers the plugins the team owns. While the organisation requires approval, it shows on and can't be changed.
### 2. Nominate approvers
- **The organisation's approvers:** under **Approval** on General, add people to **Approvers**. Choose anyone in the organisation, with or without a role. They see every plugin and its activity, and change nothing.
- **A team's approvers:** on the team's page, tick **Approver** beside each person who should approve its plugins. See <mention-page url="https://app.notion.com/p/41b4815eed4f817e9c85d2a5f5f1fa9f">Teams</mention-page>.
An approver with no role signs in to the Tilt Base web app to approve. They see the plugins they approve read-only, the **Inbox**, and the usage of those plugins. See <mention-page url="https://app.notion.com/p/41b4815eed4f81b5a34bd334676bcbb3">Roles and permissions</mention-page>.
## Who can approve
<table header-row="true">
<tr>
<td>Plugin owned by</td>
<td>Who can approve or decline its requests</td>
</tr>
<tr>
<td>The whole organisation</td>
<td>Organisation Admins and the organisation's approvers</td>
</tr>
<tr>
<td>A team</td>
<td>The team's Admins and Approvers, the organisation's approvers and organisation Admins</td>
</tr>
</table>
Nobody approves their own request, except an organisation Admin, whose approval is recorded as self-approved.
## Request approval
Anyone who can publish the plugin can request approval.
1. Choose **Request approval**, where **Publish** usually is.
2. Confirm. Approvers see the request in their **Inbox**.
Changes you make afterwards aren't part of the request. They need another request, which replaces the one waiting. The plugin's **Overview** shows its latest request and what became of it.
Organisation Admins see **Approve and publish** in place of **Request approval**. It makes the request and approves it at once, recorded as self-approved.
## Decide a request in the Inbox
**Inbox**, in the sidebar, is for approvers. It shows how many requests are waiting. Its **Waiting** list holds the requests you can decide, and **Decided** holds up to 20 decided in the last 30 days. A **Needs approval** badge also marks each plugin with a request you can decide.
1. Choose a request. It shows who requested it, the plugin's owner, and the version it's **Compared with**.
2. Review the changes. A file tree lists each change, with a folder for each skill; choose a file to see its diff, **Unified** or **Side by side**. A managed skill shows your preferences and files, never Tilt's instructions.
3. Decide:
	- To approve, choose **Approve**, then **Approve and publish**. Members' agents get the plugin as the request froze it, as the next version, on their next request. Edits made since stay as unpublished changes.
	- To decline, choose **Decline**, enter a **Reason**, then choose **Decline**. Nothing is published, and the person who requested it sees your reason on the plugin.
## Withdraw a request
While a request is waiting, the person who made it, or anyone who can publish the plugin, can choose **Withdraw request** on the plugin's **Overview**.
While a request is waiting, the plugin can't be moved to another owner or deleted.
## Request outcomes
<table header-row="true">
<tr>
<td>Outcome</td>
<td>What it means</td>
</tr>
<tr>
<td>**Waiting for approval**</td>
<td>Waiting for an approver.</td>
</tr>
<tr>
<td>**Approved**</td>
<td>An approver approved it, publishing the version named.</td>
</tr>
<tr>
<td>**Approved and published**</td>
<td>An organisation Admin approved their own request. It's recorded as self-approved.</td>
</tr>
<tr>
<td>**Declined**</td>
<td>An approver declined it, with the reason shown.</td>
</tr>
<tr>
<td>**Superseded**</td>
<td>A newer request replaced it, or a version was published without it. It can no longer be approved or declined.</td>
</tr>
<tr>
<td>**Withdrawn**</td>
<td>Someone withdrew it before it was decided.</td>
</tr>
</table>
On the **Versions** page, a version an approval published is marked **Approved** or **Self-approved**. See <mention-page url="https://app.notion.com/p/41b4815eed4f8162941ed9732567b645">Publish and versions</mention-page>.
## When approval stops
Switch off **Require approval** and publishing is direct again. A request still waiting can be approved, declined or withdrawn, and publishing directly supersedes it.
## Troubleshooting
- **"You can't approve your own request."** Another approver needs to decide it.
- **"Your request for these changes is already waiting for approval."** Wait for the decision, or change the plugin and request again.
- **Approve and Decline are dimmed on a request.** It was superseded. Open the newer request or the version that replaced it.
## Related
- <mention-page url="https://app.notion.com/p/41b4815eed4f8162941ed9732567b645">Publish and versions</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f817e9c85d2a5f5f1fa9f">Teams</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81b5a34bd334676bcbb3">Roles and permissions</mention-page>
- <mention-page url="https://app.notion.com/p/41b4815eed4f81688775cf0aaca8d164">Organisation settings</mention-page>