# Upgrade the Editor

## Overview

Below are the section summaries for upgrading to a new Morpheus Platform version:

* Downloading the new MSquared editor version
* Upgrading your Unreal project and ensure compatibility
* Changing the default editor download version in your dashboard

## Downloading the new editor

Click the <img src="/files/vnQPLOvQ2xjLzjgw0G2x" alt="" data-size="original">button to open the download modal.

Click the `Select older version` dropdown and select the version you wish to upgrade to.

Click the `Download` button and accept the popup to start the editor download

## Upgrading your Unreal project

Once downloaded, you're ready to update your local project content to the new Morpheus Platform version.

Select your existing project and click `Open` (or alternatively click `Browse...`).

<figure><img src="/files/k8FVgiqxTnaBivmCPlfc" alt=""><figcaption><p>Opening an Existing Project</p></figcaption></figure>

You will be prompted to convert your project.

Click `More Options...` and then `Convert in-place`.

<figure><img src="/files/osZZyzL8GqZSTa7Fwjsh" alt=""><figcaption><p>Converting a Project</p></figcaption></figure>

{% hint style="info" %}
This will modify your local .uproject file, so be sure to include the file in any project update change list modifications in your source control tool. You can now open your project by simply clicking on the uproject file.
{% endhint %}

Refer to the [Breaking Changes](/platform-documentation/creation/unreal-development/release-notes.md) section of the MSquared version to provide the necessary content and config changes to update your project.

Once all breaking changes have been addressed, your project update is complete. [Re-upload your mod](/platform-documentation/creation/unreal-development/getting-started/uploading-content.md) to update it to the editor version you're now using.

You can verify this by checking the Morpheus Platform Version on the [mods page](https://showcase.m2worlds.io/developer/mods/) for your mod.

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

## Changing the dashboard default version

Lastly, you can other change the default download button so that others in the metaverse can download the updated version.

From your metaverse dashboard, click the ![](/files/6waoqgmkNxuyqIYY4PYa)button.

In the `Defaults` section, update the build tag section to match that of the version of Morpheus Platform you want to update your project to and click <img src="/files/3ar3INLQ5rdR8Z3JPNtV" alt="" data-size="original">

<figure><img src="/files/eiu6qK49e4kbwVKo31vV" alt=""><figcaption><p>Updating a project to v19.0.0</p></figcaption></figure>


---

# 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.otherside.xyz/platform-documentation/creation/unreal-development/tutorials/upgrade-the-editor.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.