# Approvals

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](https://docs.scaleflex.com/vxp-visual-experience-platform/settings/organisation/users/custom-levels) 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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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](https://docs.scaleflex.com/settings/storage/listing#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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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&#x26;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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scaleflex.com/digital-asset-management-dam/library/assets/asset-details-window/asset-information-tabs/approvals.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
