> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/digital-asset-management-dam/library/assets/asset-details-window/asset-information-tabs/approvals.md).

# Approvals

Manage asset's approval status

The Approvals feature lets you gather structured feedback and decisions from stakeholders through a voting process. It ensures alignment and reduces errors, particularly for campaigns and projects with multiple contributors.

## Key usecases

* Reviewing designs for marketing campaigns.
* Approving edited images before publishing.
* Gaining consensus for social media posts or web assets.
* Streamlining multi-department approvals for promotional materials.

Any asset can be submitted for an approval. "Approval" can adopt whatever definition your project needs, e.g. "Approval for website use".&#x20;

## Pre-requisites

Approvals must first be enabled for your project, which can be done by any [user](/vxp-visual-experience-platform/settings/organisation/users/custom-levels.md) having access to [Settings > DAM > Automations > Workflows](https://hub.filerobot.com/settings/dam/automations/workflows):

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FTR4E10kXWFKPcPlKatU5%2Fimage.png?alt=media&amp;token=ab0c77d9-fdf3-4d4d-9da3-15ec8b44379c" alt=""><figcaption></figcaption></figure>

## Approval statuses

An asset, requested for an approval, can have these statuses:

<table><thead><tr><th width="263"></th><th></th></tr></thead><tbody><tr><td><code>Pending</code></td><td>Waiting for votes</td></tr><tr><td><code>Approved</code> </td><td>The asset has passed approval criteria and is fit for use*</td></tr><tr><td><code>Rejected</code></td><td>The asset has failed the approval criteria and is not fit for use*</td></tr><tr><td><code>Cancelled</code></td><td>When a Requester (or user with the necessary permission) has explicitly cancelled the request</td></tr><tr><td><code>Reset</code></td><td>When someone has edited the file and created a new version during an active approval request</td></tr></tbody></table>

\*see [Approval vote outcome](#approval-vote-outcome) section below

## Approval vote outcome

An approval request is considered:

* **Approved**: When all approvers vote positively.
* **Rejected**: When at least one approver votes negatively or [the request Due date expires](#due-date-expiration).

If an asset is rejected, the requester can review comments, make adjustments, and submit a new approval request.

{% hint style="info" %}
There can be only one active (pending) approval request per asset, however, once completed, another one may be requested.
{% endhint %}

## Due date expiration

If an approval is not approved by the due date, the approval is **automatically rejected**.

## Requesting an approval

An approval can be requested in several ways:

1. From the Context menu > More actions > **Manage approval**

   <figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FqjL1xUqPifhwAy4vVZMI%2Fimage.png?alt=media&amp;token=2519bf96-00dc-44dd-bd8b-3695573c6c97" alt="" width="248"><figcaption></figcaption></figure>
2. From the Library sidebar - expand the **Approval status** section and click the **Manage approval** link

   <figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2F6ynA2rcjaP6yJvilnnMl%2FScreenshot%202024-11-22%20at%2014.17.45.png?alt=media&amp;token=23a02176-a6ca-49c6-830f-a3dc63e91214" alt="" width="375"><figcaption></figcaption></figure>
3. From the Asset details window - go to the **Approvals tab** and click **Request approval**.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FcAIiKhb0ZDqJLhDUxJMA%2Fimage.png?alt=media&amp;token=2e10c583-6b76-4649-88ec-7f89fdda1b41" alt="" width="375"><figcaption></figcaption></figure>

### Steps to request approval:

1. Click the **Request approval** button to open the **Request approval** modal.
2. Complete the following fields:
   * **Selecting approvers**: Choose one or more approvers. Users without asset access are muted and cannot be selected. At least one approver is required to enable the **Send request** button.
   * **Adding an optional message**: Provide additional context for the approvers (eg. "*Please review this image for use in next month’s newsletter").*
   * **Setting a due date**: Set a realistic deadline for the review process. The local time is auto-detected.
3. Once the **Send request** button is clicked, all approvers receive an alert.

<div align="center"><figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2Fb2H4X2V8xvsNi1E66vIc%2Fimage.png?alt=media&amp;token=88843e63-90ef-45f8-8c3d-095bad9c2eeb" alt="" width="375"><figcaption></figcaption></figure></div>

## Voting on approval request

Approvers will get a notification when they are asked to vote on a request. An approver can click on the link in the notification or navigate manually to the asset. Once in Asset details window > Approvals tab:

1. Click on the **View and approve** link
2. Then choose to either **Approve** or **Reject** the asset
3. You can leave comments when voting, in this way providing immediate feedback like: "*Please adjust the font size in the banner."*

<div><figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FjUDpRPnFZBPy8BRizzOr%2Fimage.png?alt=media&amp;token=4267e392-d78c-44f3-ba5b-94b575ec8557" alt=""><figcaption></figcaption></figure> <figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2Fo3yfDvIfaC3R06TqPzFY%2Fimage.png?alt=media&amp;token=ba807a93-cc17-493f-a7da-00679bbc5d5c" alt=""><figcaption></figcaption></figure></div>

## Manage approval request

Active requests can be modified by the original requester or [anyone with the necessary permissions](/digital-asset-management-dam/settings/storage/listing.md#default-gallery-role) (if not listed as an approver).&#x20;

### How to manage an approval request

* Open the **Approvals tab** in the Asset details window.
* Click **Manage approval** to view details.
* Make changes as needed:
  * **Cancel**: Notify approvers and stop the approval process.
  * **Edit**: Modify approvers, due dates, or messages.

{% hint style="info" %}
At least one approver must remain, and the due date must be in the future.
{% endhint %}

<div align="center"><figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FkXCGvUwvwi4NybAXMzwk%2Fimage.png?alt=media&amp;token=f3f997ac-1217-4f8a-820e-2a3fc2641ee3" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FCdiMoX6XNnHftBAszMyv%2Fimage.png?alt=media&amp;token=6d9968a1-3584-4a54-898f-1552cc31eb14" alt="" width="375"><figcaption></figcaption></figure></div>

## Viewing approval details and history

### Regular users:

Regular users can view approval details but cannot take action or leave comments.

### Where to view approval statuses:

The approval status is displayed in the following locations:\
\
1\. **Asset thumbnails -** Approval status is displayed on the top-right corner (not clickable).

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FbtcWBK2QENzM42ygrg92%2Fimage.png?alt=media&amp;token=ac36e88a-517a-47eb-aa7a-6d634e2cfbff" alt=""><figcaption></figcaption></figure>

2\. **Library sidebar -** a field in the General tab shows the approval status. Hovering over it displays a summary tile.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FiGgfMhkBQMOc2t3ucdMi%2Fimage.png?alt=media&amp;token=50e7cddb-ddfc-47d8-9a4e-736dcb8dc9e5" alt=""><figcaption></figcaption></figure>

3. **Approvals tab -** Provides a detailed history of all approval requests.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2Ft11G3mXQGKMGupcByHZq%2Fimage.png?alt=media&amp;token=37517197-b9b3-40c6-97d0-f89b5fb42f27" alt=""><figcaption></figcaption></figure>

### Approval history

1. Open the **Approvals tab** in the Asset details window.
2. Click **History** to view previous approval requests.
3. Select the file version from the left panel and click **View details** for more information.

<div><figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2F9OoTNnYYysEBHCifSodT%2Fimage.png?alt=media&amp;token=9090c81c-8566-4392-897e-2f03e8a4ddc1" alt=""><figcaption></figcaption></figure> <figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FBXtar11tpb8VoRdQghcT%2Fimage.png?alt=media&amp;token=008615ac-cc65-4576-bc25-e9150c8f0b67" alt=""><figcaption></figcaption></figure></div>

## Best practises for using Approvals:

* Use clear messages to explain the purpose of the approval.
* Set realistic due dates to allow stakeholders enough time to vote.
* Regularly review approval history for process insights.
