Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Creating Your First Template

Umbraco creates a corresponding template when you select the Document Type with Template option when creating a Document Type. A Document Type defines your content's structure, while a Template defines how that content is rendered on the front end. See Document Type Options for a full breakdown of when to use each option.

To edit the template:

  1. Go to Settings.

  2. Expand the Templates folder in the Templating section of the tree. You should see a template titled HomePage.

If you do not see the template, try refreshing the page.

  1. Open the template. It contains a little bit of Razor code.

    Code Breakdown:

    • @using Umbraco.Cms.Web.Common.PublishedModels; - Imports the namespace containing Umbraco's strongly-typed content models (generated by ModelsBuilder).

    • @inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage<ContentModels.HomePage> - Sets the view to inherit from Umbraco's base view class, strongly typed to the HomePage model. This gives Model compile-time typed access to HomePage's properties instead of the generic IPublishedContent.

    • @using ContentModels = Umbraco.Cms.Web.Common.PublishedModels; - Creates the ContentModels alias used above in the @inherits directive, so you can write ContentModels.HomePage instead of the full namespace.

    • @{ Layout = null; } - The view will not use a layout page unless explicitly specified. For more information on Razor Pages Layout, see the Microsoft Documentation.

    Home Page Template

Use the files from the Custom Umbraco Template folder:

  1. Open the Custom Umbraco Template folder and copy the contents of index.html.

  2. Paste the content into the HomePage template below the closing curly brace "}".

    • Umbraco Templates uses Razor that allows you to add code in your Template files. Razor reacts to @ signs.

  3. Click Save.

There is now a Template in place. That's two out of the three stages complete for the first page.

Creating Your First content node

Our third and final stage to creating our first page in Umbraco, is to create a content node. The content node uses our Document Type and Template to serve up an HTML page to web visitors.

To add a content node:

  1. Go to Content.

  2. Select ... next to Content in the tree.

  3. Click Create.

  4. Select HomePage. The Home Page opens in the content editor.

    • If you cannot see the content node, check that Settings > Document Types > HomePage > Structure > Allow at root is enabled.

    Home Page Content Node
  5. Enter the Name for the content node. Let's call this Homepage.

    • The name will show up in the node list and will be used to create a URL for the page. Try to keep it short but descriptive.

  6. Enter the following details:

Name
Description

Page Title

Welcome to Widgets Ltd

Body Text

Lorem ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam et aliquet ante, ut eleifend libero.

  • Proin eleifend consequat nunc id vulputate.

  • Ut eget lobortis metus, non congue lorem.

  • Orci varius natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

  • Maecenas tempus non lectus rhoncus efficitur.

Sed est ligula, maximus in dolor sed, lacinia egestas ligula. Donec eu nisi lectus.

Morbi pharetra pulvinar arcu non gravida.

Footer Text

Copyright Widgets Ltd 2026

  1. Click Save and Publish. The content tree will reload with the homepage node.

    Home Page in Content Tree

Accessing the Frontend

To view your content on the frontend:

  1. Go to the Info tab in the Homepage content node.

  2. Click on the link under the Links section.

The default Umbraco page is gone and you will see a basic unstyled page.

If you see a blank page, check if the template is entered and remember to save it.

An Unstyled Homepage

Last updated

Was this helpful?