Bubble Docs

Terminology: Version control

This section contains terminology related to the version control system
This page contains short descriptions of the version control terminology. For a more comprehensive guide on version control works or the core reference of all the available features, see the links below:
Article: Version control
Reference: Version control
The terminology used by Bubble's version control system may not be immediately apparent or easy to grasp at first. This article contains a list of the different terms used and may be helpful as you get to know how the system works.
At the bottom of the page you will find terminology that has changed from the legacy system.


base branch
The branch that you want to merge changes into
branch tree
The visualization that shows you where a branch came from and how it relates to other branches
child branch
A branch that has a parent branch; a child branch can also be a parent branch
Conflicts arise during the merge process when the base branch and the source branch each changed the same thing (in different ways) since the last time the two branches were in sync
conflict resolution
Conflict resolution is the process of resolving conflicts. The conflict resolution window organizes conflicts by page and gives you the option to resolve all conflicts in favor of one branch on a page-by-page basis.
custom branch
Apps on the higher plans can have one or more custom branches
deploy, deployment
To deploy a branch is to push changes to Live. Only the Main branch and the hotfix branches can be deployed to Live.
Development environment
The development environment contains Main, any custom branches, and hotfix branch
Environments contain branches. There are two environments: live and development. The environment is defined by the database that it uses (i.e., the live environment uses the live database, while the development environment uses the development database).
hotfix branch
The hotfix branch is the only branch that can branch off of Live. Only one hotfix branch can exist at a time. While a hotfix branch exists, Main cannot be deployed to Live. Hotfix is available on higher plans.
in sync
When two branches are in sync, there are no conflicts that would be generated from merging the two branches
Live is the version of your app that lives on the internet for users to interact with
Live environment
The live environment contains Live
Main branch
All apps have a Main branch. Main is the only branch that can be deployed to Live (aside from hotfix). Main sits at the very top of the branch tree hierarc
merge, merging
The process of integrating changes from the source branch into the base branch
parent branch
A branch that has child branches branching off of it; a parent branch can also be a child branch
resolve conflicts
To resolve conflicts that arise during the merge process, you must select which change to favor
To restore is to return to a past version of a branch by using the savepoint feature or by entering a custom date/time
Savepoints are automatically created in the base branch when you deploy to Live, start a merge, finish a merge, cancel a merge, or right before you restore your branch. Custom savepoints are savepoints that you can manually create at any time.
savepoint retention window
An app’s savepoint retention window dictates how far back you can restore any one of your branches
source branch
Refers to the branch that is the source of changes that you want to merge into the base branch
To sync two branches is to merge them for the purposes of bringing changes in Live or Main into the base branch
to branch, branching
To create a branch off of another branch
version control
The system for tracking and managing changes to your app.

Legacy terminology and replacements

If you have been using Bubble for some time you may be familiar with the existing terminology that surrounded the previous version control. The following terms have been removed or replaced
Adding changes from one version to another
Now "merging"
Now "Main branch"
live version
Now "Live"
custom version
Now "custom branch"