Welcome to Umbraco Cloud

    We're excited you have decided to use Umbraco Cloud!

    What's up with the name Umbraco Cloud?

    Since Umbraco Cloud is Umbraco in a cloud environment we thought we'd stick with a name that describes what it is. So there you go.

    Projects and Environments

    In Umbraco Cloud we organize your work into projects which are made of environments, teams, settings, and other related resources like databases and file storage. A project is comprised of different numbers of environments depending on which plan you are on. If you choose the Starter plan then the project comes with a single live environment and you have the option to add a development environment and a staging environment. If you choose the Professional plan the project will have a Development AND a Live environment. As with the Starter Plan you can add/remove environments as needed.

    When your project is running in trial mode your live environment is protected with the basic authentication. The basic authentication will be removed when you pay for the project. Development and Staging environments are always protected with basic authentication

    You can avoid basic authentication by whitelisting IP addresses for the appropriate environments. See IP Whitelist for more information. environment

    Set up and Code

    For developers, you will use the Development environment to set up the site. To create and test code, clone Development to your local machine and then, once things are just how you like, push the changes back to Umbraco Cloud. Your changes will be added to the Development environment automatically and added to the deployment queue. To deploy to the Live environment, simply push the deploy button and everything will be deployed to the Live environment. See more about this in the deployment section.


    For content editors, you will use the Live environment to create and edit your content. Developers can always restore to the latest content on the Development or local environments.

    If the project contains a Staging environment and you create your content here, be aware that content doesn't get added to the deployment queue automatically. Once you're ready to deploy the content to the Live environment, add it to the deployment queue using the Queue for transfer feature in the backoffice.

    Finding your Umbraco Project

    To navigate to your project, simply log in to the Umbraco Cloud portal and then click on the project you want to use.


    We create your project’s URL using the name you used when you created the project, and then we add s1.umbraco.io. If you named your project Snoopy, your project URL will be snoopy.s1.umbraco.io and your project’s Umbraco backoffice URL will be snoopy.s1.umbraco.io/umbraco. For the Development environment we prefix with dev- so the URLs will be dev-snoopy.s1.umbraco.io and dev-snoopy.s1.umbraco.io/umbraco. You'll find all environments for a project listed on the Project page.


    Logging in to Umbraco

    When working with a trial project on Umbraco Cloud you need to log in to work with the Umbraco backoffice and also to view your site. The user name and password for both locations are the same as the username and password you use for the portal. Once you upgrade to any of the non-Trial versions you’ll no longer need to login to view your live site but, of course, will still need to log in to the backoffice.

    From your Project page select the Go To Backoffice link to login to the backoffice and the View Page link to view your site.

    Making changes to your site

    This is where you get to make your Umbraco project your own. Umbraco is built using web standards - things like HTML, CSS, and JavaScript. You’ll find the HTML that makes up the Templates for your site in the Umbraco backoffice Settings section, under the Templates tree. This is plain-old-HTML, so feel free to change or replace what’s there. The same goes for your project’s CSS (it’s in the Stylesheets tree) and the JavaScript (yup, in the Scripts tree). See the Umbraco documentation for more information.

    Starting with a Baseline

    Beyond the basics of creating a new project, you may wish to start with a Baseline project. Read more about Baselines and how to work with Baseline Projects.