> For the complete documentation index, see [llms.txt](https://help.metaforms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.metaforms.ai/survey-programming-decipher/unified-flow/change-management/starting-a-new-version.md).

# Starting a new version

### Prerequisites

Before starting, make sure you have:

* The previous (or initial) questionnaire version already loaded in your project. Read how at [Starting a Decipher Project in Unified Flow](/survey-programming-decipher/unified-flow/starting-a-decipher-project.md).

  \
  You can also import your existing Decipher project XML and start change management on top of it. Read Step 8 in the above article to learn how.
* The updated files ready to upload (e.g., new questionnaire document).

***

### Upload & Start the New Version

**Step 1:** Open your existing project in Metaforms and click **Upload New Version** on the right side.

<figure><img src="/files/DsnFikKjX1kmnstiPcQi" alt=""><figcaption></figcaption></figure>

**Step 2:** Enter a name for the new version — this could be a wave name or any identifier that helps you track iterations.

<figure><img src="/files/Ug5Sbh2zxDKNrJRgxS3v" alt=""><figcaption></figcaption></figure>

**Step 3:** Upload the files you want to update (e.g., the new questionnaire). Replaced files will be marked as updates; any files you don't replace will carry over from the previous version.

<figure><img src="/files/WcZnOYNWRDzMtioMs7KE" alt=""><figcaption></figcaption></figure>

**Step 4:** Click **Create** to finalize the version. Metaforms will process your upload and prompt you to choose how to proceed.

**Step 5:** Select how you'd like to manage the new version on Decipher. You can choose to create a duplicate survey or overwrite the existing project.

<figure><img src="/files/pINhEA1bzThmVLpyIGIg" alt=""><figcaption></figcaption></figure>

**Step 6:** Select **Change Management** to enter the structured review workflow, then click **Start Version**.

{% hint style="info" %}
Incase the survey is currently live, you can select the "Survey is current live / in-field" option to ensure the newer updates are synced to a temporary version on Decipher.
{% endhint %}

<figure><img src="/files/O1bj78YPOO5pcZyuBbUa" alt=""><figcaption></figcaption></figure>

You'll now enter the **Review** stage. See[Review Stage](/survey-programming-dimensions/change-management/review-stage.md) for next steps.


---

# 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://help.metaforms.ai/survey-programming-decipher/unified-flow/change-management/starting-a-new-version.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.