We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
Go to docs.umbraco.com for documentation for Umbraco 9 and newer versions.

    Baselines

    A Baseline Child project is very similar to a Fork (forked repository) on GitHub where we create a clone of an existing project while maintaining a connection between the two projects. The connection exists between the Live environment of the existing project, the Baseline project, and the Development or Live environment - of the newly created project, the Child project.

    Any project can act as a Baseline project.

    The basic idea is that you have a project that contains all your standard Umbraco packages/components, maybe even configured with some default Document Types, which you want to use as a baseline for future projects. When you've made changes to your Baseline project, you can then push these changes out to all the Child projects with a click of a button.

    Baseline workflow

    For some more in-depth information have a look at the High-level Overview article.

    Currently, the baseline feature is only available in the west EU region.

    At this point, it is not possible to create baselines if you are hosting your site in the East US region.

    Video Tutorial

    Creating a Child Project

    To create a child project:

    1. Log in to the Umbraco Cloud Portal.
    2. Click the Create New Project button.
    3. Select Umbraco Cloud from the Create New Project window.
    4. Choose either Starter, Standard or Professional plan from the Plan Selection window.
    5. In the Project Information window, enter the Project Name.
    6. [Optional] Select Create from Baseline.
    7. From the Choose baseline drop-down list, select the Cloud project, the new project should be based on.

    Any Umbraco Cloud project can be used as a Baseline project

    1. Choose an Owner from the drop-down list.
    2. In the Technical Contact section, enter your Name, Email, and Telephone.
    3. Select I have read and agree to the terms and conditions and the Data Processing Agreement.
    4. Click Create Project.

    It might take couple of minutes for the project to spin up before your environments are ready. When your environments are ready, you will see a green light next to the environment name.

    Creating a Baseline child project

    Depending on the size of the project you've chosen as a Baseline project, it might take several minutes before the Child project is ready.

    Restore content from the Baseline project

    When you've created the Child project you can choose to restore content from your Baseline project:

    1. Go to the Content section.
    2. Right-click the top of the Content tree in the Umbraco backoffice.
    3. Choose Workspace Restore.
    4. The Baseline project should already be selected as the environment to restore from
    5. Click Restore from Baseline

    If you do not see the content, Reload the content tree once the restore is complete.

    Restore content from Baseline project

    Merge Conflicts

    As with any Git repository-based development, it is not uncommon to have merge conflicts as the repositories begin to differ. Read this article for more on the merge strategy we use and how to approach resolving these conflicts.

    Pushing upgrades to a Child Project

    In this article, you'll find a guide on how to upgrade your Child project with changes from your Baseline project.

    Handling configuration files

    When you are working with Baseline Child projects you might sometimes want to have an individual configuration for each project - this can be handled using config transforms.

    Break reference between baseline and child project

    In this article, we will look at how to break the connection between the baseline and one of its child projects.