> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/form-management/publish-deploy/approval-workflow.md).

# Approval Workflow

## 🔢 What is the approval workflow ?

By default, any changes or additions made to a survey are immediately live and visible to respondents.

When the Approval Workflow is enabled, you can work on a separate draft version of the survey while respondents continue to access the current published version.

Changes made to the draft do not affect the published survey until a new version is published. Depending on your approval workflow configuration, the draft can either be:

* Published directly, making the new version available to respondents immediately; or
* Submitted for approval, in which case the new version becomes available to respondents only after it has been reviewed and approved by the designated approvers.

This allows you to safely prepare and review changes without affecting the version of the survey currently available to respondents.

## 🚀 How to enable the approval workflow ?

Approval workflow can be enabled separately on any existing folder of your choice. Once enabled on a folder all surveys of that folder will require to match the approval settings that you have defined.

1\) Start by enabling it on your folder&#x20;

<figure><img src="https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8fLhS0bmfBRyq0HdUm%2Fuploads%2FoZ3IY64wE5DP5KNjoCTp%2Fimage.png?alt=media&amp;token=db23fdb3-d1a8-4358-8d71-37371a30f5e5" alt=""><figcaption></figcaption></figure>

2\) Add the users or groups responsible for approving surveys before they are published. Each assigned user, or each member of an assigned group, will receive an email notification requesting their approval.

All assigned users must approve the survey. For groups, approval from one member of the group is sufficient. If any required approver rejects the survey, it will not be published.

![](https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8fLhS0bmfBRyq0HdUm%2Fuploads%2FSdoEU9HyVwyobKm2NUs1%2Fimage.png?alt=media\&token=5bf4ad0c-96af-4a3c-915e-5fe5821aa669)

{% hint style="warning" %}
If no users or groups are assigned as approvers, the approval workflow simply requires users to publish their draft before any changes become visible to respondents.
{% endhint %}

## 👥 How to approve a survey ?

Surveys that needs to be approved are visible in the To be approved section of the approver&#x20;

<figure><img src="https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8fLhS0bmfBRyq0HdUm%2Fuploads%2FXLMyiHt8nV6ouDukERNK%2Fimage.png?alt=media&amp;token=8e9b87ac-3eae-45e9-9486-364ff977c973" alt=""><figcaption></figcaption></figure>

These surveys will be displayed to the approved in Preview / Test mode and each approver can choose to approve or reject the new version.

<figure><img src="https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8fLhS0bmfBRyq0HdUm%2Fuploads%2FmSxVfJUlqadmXuN74NH8%2Fimage.png?alt=media&amp;token=f925a544-bb39-4c7c-893c-87c0ce600723" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ngsurvey.com/form-management/publish-deploy/approval-workflow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
