Skip to content

Git in Designer

Git is a tool used for source control management in software development. It helps developers keep track of changes made to a project's source code, and collaborate without overwriting each other's work.


Matillion Designer is built with Git from the ground up for version control, making it easier to collaborate and manage your data pipelines within your team. Git in Designer offers you:

  • Version control: Git keeps a history of every commit, allowing developers to view and track progress in a project.
  • Collaboration: Multiple developers can work on the same project simultaneously, and Git ensures that everyone has access to the most recent version of the pipeline.
  • Branching and merging: Git makes it easy to create new branches for experimenting with new features, or for fixing bugs. You can then merge those branches back into the main codebase.
  • A distributed system: Git is a distributed version control system, which means that each developer has their own copy of the remote repository on their working directory. This makes it easy to work in isolation and merge changes back into the main codebase later.

It's important to note the following differences between Matillion Designer and Git:

  • When you work on Designer, you do not have a copy of the files in your local machine. Instead, you’ll have an online copy of the remote repository. This is essentially your working directory where all changes are staged until you commit and push to the remote repository.
  • When you commit, you're actually doing a "commit and push to remote repository" action as one.

Read Add branch to learn how to add a branch.


When you create a project in Your projects, an associated Matillion-hosted Git repository is created with a default branch called main.

To start creating orchestration and transformation pipelines, click on the branch you want to check out, and you will be redirected to the Designer UI.

We recommend using branches other than main to develop your orchestration and transformation pipelines.

Read Add branch to learn how to add a branch.

Git actions

You can find the available Git actions inside the Git drop-down menu on the Designer toolbar.

  • Learn how to commit changes to your pipelines, creating a new snapshot of the code. Note that a commit also pushes to the remote repo, allowing other team members to access (pull) the changes.
  • Learn how to pull changes from remote to your copy of the branch, updating your working directory version of the code. A branch that is behind remote cannot be committed.
  • Learn how to merge your committed work. To see someone else’s merged changes, you will need to pull from remote.