Skip to main content
Version: 1.12

Change Project Editor Version

Each project in Godot Launcher can use a different Godot editor. Change it when a project needs another installed or registered release, a downloadable compatible official release, a .NET build, or a custom build.

Opening Project Settings and changing the Godot editor versionOpening Project Settings and changing the Godot editor version

Choose another Godot editor​

  1. Open the Projects view.
  2. Select Project settings on the project card.
  3. Stay on the Project tab.
  4. Choose an installed version from Godot Editor, or select Browse releases to choose a compatible official editor to download.
  5. Select Update, or Install and save for an editor that is not yet installed.

The project uses the selected editor the next time you open it. Its folder and project.godot file do not move.

For a downloadable editor, Install and save saves the selected version before starting its download. Project Settings closes and the project shows the selected version and download progress. You can reopen Project Settings to make further changes while the editor installs.

If installation fails or is cancelled, the selected version stays saved. Use Install required editor on the project to retry, or select another installed editor. A completed download does not replace a newer editor choice.

info

Godot Launcher offers editors from the project's current Godot major version or newer. An editor appearing in the picker does not guarantee that your project is compatible with it. Follow the official Godot upgrading guide before opening a project with a different major version.

Use an official or custom build​

Official releases and registered custom builds appear together in Godot Editor. The release browser shows compatible official releases from the stable and pre-release catalogues. Custom builds are useful for locally compiled or team-provided versions.

See Custom-Built Godot Editors to register or replace one.

Keep the code editor working​

Changing the Godot editor does not change the project's Visual Studio Code or VSCodium choice.

If the project uses either editor and it is available, the launcher updates its project setup for the new Godot version. This includes supported build and debug setup when you choose a .NET editor.

To choose another code editor, open Project Settings > Code Editor.

If the selected editor is no longer available, see Troubleshooting.