Skip to main content

Manage Source Control branches

Learn how to view, edit, delete, and switch Source Control branches.

On Retool Cloud and self-hosted Retool versions 3.6.0 and later, you can:

  • Edit multiple apps, modules, and queries on the same branch.
  • Commit changes directly in the editor.
  • Switch between branches and apps using the Branch menu.

These features are only available for Source Control with GitHub. On earlier Retool versions and when using other SCM providers, a branch only tracks a single app or module.

Edit apps, modules, and queries

With multi-element branching, you can edit apps, modules, and Query Library queries on a single branch. Each commit contain changes for a single app, module, or query, but branches can contain commits across apps, modules, and queries. This allows you to combine your dependent changes into a single pull request, instead of creating and merging pull requests for each dependent module or query.

Branch menu

From the branch menu in the bottom left status bar, you can:

  • View your commit log.
  • Switch branches.
  • Edit other apps and modules on the same branch.
  • Create a pull request.
  • Rename, reset, and delete your branch.

Build apps on and off branches


When you open a new tab, you are always on the main branch.

When you create a new app or module while you're on a local branch, you can create it on or off your branch.

When you select Create on current branch, the app or module is created locally on your branch and considered In development. Apps and modules in development are only visible to their creators on the local branch until they are merged into source control repositories. After you merge an In development app or module to your source control repository, it is visible to the rest of your organization. In development apps and modules are useful when you want to privately develop and iterate on apps before you share them widely.

When Create on current branch is not selected, the new app or module is not protected.


To preview a branch of an app pushed from another instance, create a new branch in your current instance, and select Reset branch in the status bar. Select the relevant branches in the modal to pull in the origin branch changes.

Reset branch modal