Defining content - Our Umbraco

<!doctype html>  <html class="no-js" lang="en">  <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="alternate" type="application/rss+xml" title="Latest packages" href="//our.umbraco.com/rss/projects" /> <link rel="alternate" type="application/rss+xml" title="Package updates" href="//our.umbraco.com/rss/projectsupdate" /> <link rel="alternate" type="application/rss+xml" title="Active forum topics" href="//our.umbraco.com/rss/activetopics" /> <link rel="search" type="application/opensearchdescription+xml" title="our.umbraco.com" href="/scripts/OpenSearch.xml">  <meta name="application-name" content="Our Umbraco" /> <meta name="apple-mobile-web-app-title" content="Our Umbraco">  <link rel="apple-touch-icon-precomposed" href="/assets/images/app-icons/icon-60.png"> <link rel="apple-touch-icon-precomposed" sizes="72x72" href="/assets/images/app-icons/icon-72.png"> <link rel="apple-touch-icon-precomposed" sizes="76x76" href="/assets/images/app-icons/icon-76.png"> <link rel="icon" sizes="192x192" href="/assets/images/app-icons/touch-icon-192x192.png"> <meta name="msapplication-TileImage" content="/assets/images/app-icons/tile.png" /> <meta name="msapplication-config" content="/assets/images/app-icons/browserconfig.xml"> <link rel="icon" type="image/png" href="/assets/images/app-icons/favicon.png"> <meta name="robots" content="noindex"> <title>Defining content - Our Umbraco</title> <meta name="description" content="Here you'll find an explanation of how content is defined in Umbraco 8" /> <link rel="canonical" href="https://docs.umbraco.com/umbraco-cms/fundamentals/data/defining-content/" /> <script type="text/javascript" src="/scripts/jquery-1.9.1.min.js"></script>  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-W9TZ2XW');</script>  <link href="/DependencyHandler.axd?s=L2Fzc2V0cy9jc3Mvc3R5bGUubWluLmNzczs&t=Css&cdv=25020301" type="text/css" rel="stylesheet"/><link href="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.css" type="text/css" rel="stylesheet"/> </head> <body class="wiki-page">  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-W9TZ2XW" height="0" width="0" style="display: none; visibility: hidden"></iframe></noscript>  <div class="quick-menu"> <div class="container"> <div class="row"> <div class="col-md-12"> <a href="/member/login">Sign in</a> <a href="/member/Signup">Register</a> </div> </div> </div> </div> <div class="wrapper"> <header> <div class="navigation"> <div class="container"> <div class="row"> <div class="col-md-3"> <a class="logo" href="/">Our Umbraco</a> </div> <div id="toggle" class="menu-toggle"> <a href="#" class="toggle cross"><span></span></a> </div> <nav class="col-md-9"> <ul> <li> <a href="/forum/">Forum</a> </li> <li> <a href="/packages/">Packages</a> </li> <li class="current"> <a href="/documentation/">Documentation</a> </li> <li> <a href="https://community.umbraco.com/">Community</a> </li> <li> <a href="https://discord.umbraco.com/">Discord</a> </li> <li> <a href="/download/">Download</a> </li> <li> <a href="/member/login?redirectUrl=%2fdocumentation%2fFundamentals%2fData%2fDefining-content%2f">Sign in</a><strong> / </strong><a href="/member/Signup">Register</a> </li> </ul> </nav> </div> </div> </div> </header> <div class="has-sidebar"> <div class="documentation"> <div class="page-content"> <div class="sidebar-area"> <div class="sidebar-content"> <div class="content-wrapper"> <nav> <details class="secondary_nav" open> <summary>Menu</summary> <ul class="level-1"> <li class=""> <a href="/documentation/Getting-Started/"><h3>Getting Started</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Getting-Started/Managing-an-Umbraco-project/"><h4>Managing an Umbraco project</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Editing-websites-with-Umbraco/"><h4>Editing websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Creating-websites-with-Umbraco/"><h4>Creating websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/"><h4>Developing websites with Umbraco</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Customizing-Umbraco-sites/"><h5>Customizing Umbraco sites</h5></a></li> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Extending-the-Umbraco-Backoffice/"><h5>Extending the Umbraco Backoffice</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Hosting-an-Umbraco-infrastructure/"><h4>Hosting an Umbraco infrastructure</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Where-can-I-get-help/"><h4>Where can I get help</h4></a> <ul class="level-3 "> </ul> </li> </ul> </li> <li class="active open"> <a href="/documentation/Fundamentals/"><h3>Fundamentals</h3></a> <ul class="level-2 open"> <li class=""> <a href="/documentation/Fundamentals/Setup/"><h4>Setup</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Fundamentals/Setup/Requirements/"><h5>Requirements</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Install/"><h5>Install</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Upgrading/"><h5>Upgrading</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Server-Setup/"><h5>Server Setup</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Backoffice/"><h4>Backoffice</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Fundamentals/Backoffice/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Property-Editors/"><h5>Property Editors</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Login/"><h5>Login</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Content-Templates/"><h5>Content Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Infinite-editing/"><h5>Infinite editing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/LogViewer/"><h5>LogViewer</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Variants/"><h5>Variants</h5></a></li> </ul> </li> <li class="active open"> <a href="/documentation/Fundamentals/Data/"><h4>Data</h4></a> <ul class="level-3 open"> <li class="active"><a href="/documentation/Fundamentals/Data/Defining-content/"><h5>Defining content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Creating-Media/"><h5>Creating Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Members/"><h5>Members</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Data-Types/"><h5>Data Types</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Scheduled-Publishing/"><h5>Scheduled Publishing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Adding-Tabs/"><h5>Adding Tabs</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Dictionary-Items/"><h5>Dictionary Items</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Relations/"><h5>Relations</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Users/"><h5>Users</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Design/"><h4>Design</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Fundamentals/Design/Templates/"><h5>Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Content/"><h5>Rendering Content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Media/"><h5>Rendering Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Stylesheets-Javascript/"><h5>Stylesheets Javascript</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-View-Macro-Files/"><h5>Partial View Macro Files</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-Views/"><h5>Partial Views</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Code/"><h4>Code</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Fundamentals/Code/Umbraco-Services/"><h5>Umbraco Services</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Subscribing-To-Events/"><h5>Subscribing To Events</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Creating-Forms/"><h5>Creating Forms</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Debugging/"><h5>Debugging</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Source-Control/"><h5>Source Control</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Implementation/"><h3>Implementation</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Implementation/Default-Routing/"><h4>Default Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Default-Routing/Inbound-Pipeline/"><h5>Inbound Pipeline</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Controller-Selection/"><h5>Controller Selection</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Execute-Request/"><h5>Execute Request</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Custom-Routing/"><h4>Custom Routing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Controllers/"><h4>Controllers</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Data-Persistence/"><h4>Data Persistence</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Rest-Api/"><h4>Rest Api</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Composing/"><h4>Composing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Services/"><h4>Services</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Services/Circular-Dependencies/"><h5>Circular Dependencies</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Unit-Testing/"><h4>Unit Testing</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Extending/"><h3>Extending</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Extending/Dashboards/"><h4>Dashboards</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Section-Trees/"><h4>Section Trees</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Section-Trees/Searchable-Trees/"><h5>Searchable Trees</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Trees/"><h5>Trees</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Property-Editors/"><h4>Property Editors</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Property-Editors/Build-a-Block-Editor/"><h5>Build a Block Editor</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Package-Manifest/"><h5>Package Manifest</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Actions/"><h5>Property Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Value-Converters/"><h5>Property Value Converters</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Tracking/"><h5>Tracking</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Macro-Parameter-Editors/"><h4>Macro Parameter Editors</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Health-Check/"><h4>Health Check</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Health-Check/Guides/"><h5>Guides</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Language-Files/"><h4>Language Files</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Search/"><h4>Backoffice Search</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Tours/"><h4>Backoffice Tours</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Backoffice-UI-API-Documentation/"><h4>Backoffice UI API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Extending/Content-Apps/"><h4>Content Apps</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Database/"><h4>Database</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Embedded-Media-Provider/"><h4>Embedded Media Provider</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/FileSystemProviders/"><h4>FileSystemProviders</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/FileSystemProviders/Azure-Blob-Storage/"><h5>Azure Blob Storage</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Packages/"><h4>Packages</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Packages/Creating-a-nuget-package/"><h5>Creating a nuget package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Creating-a-Package/"><h5>Creating a Package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Language-Files-For-Packages/"><h5>Language Files For Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Maintaining-Packages/"><h5>Maintaining Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Package-Actions/"><h5>Package Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Packages-on-Umbraco-Cloud/"><h5>Packages on Umbraco Cloud</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Types-of-Packages/"><h5>Types of Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/UmbPack/"><h5>UmbPack</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Uploading-to-Our/"><h5>Uploading to Our</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Reference/"><h3>Reference</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/"><h4>Configuration for Umbraco 7 and 8</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/404handlers/"><h5>404handlers</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/applications/"><h5>applications</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/BaseRestExtensions/"><h5>BaseRestExtensions</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/dashboard/"><h5>dashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/EmbeddedMedia/"><h5>EmbeddedMedia</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineIndex/"><h5>ExamineIndex</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineSettings/"><h5>ExamineSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/fileSystemProviders/"><h5>fileSystemProviders</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/HealthChecks/"><h5>HealthChecks</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/Serilog/"><h5>Serilog</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/tinyMceConfig/"><h5>tinyMceConfig</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/trees/"><h5>trees</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/umbracoSettings/"><h5>umbracoSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/webconfig/"><h5>webconfig</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Templating/"><h4>Templating</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Templating/Macros/"><h5>Macros</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Masterpages/"><h5>Masterpages</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Modelsbuilder/"><h5>Modelsbuilder</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Mvc/"><h5>Mvc</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Querying/"><h4>Querying</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Querying/DynamicPublishedContent/"><h5>DynamicPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/IPublishedContent/"><h5>IPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/MemberShipHelper/"><h5>MemberShipHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UmbracoHelper/"><h5>UmbracoHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UDI-identifiers/"><h5>UDI identifiers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Routing/"><h4>Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Routing/Authorized/"><h5>Authorized</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/IISRewriteRules/"><h5>IISRewriteRules</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Request-Pipeline/"><h5>Request Pipeline</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/URL-Tracking/"><h5>URL Tracking</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Controllers/"><h5>Custom Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Routes/"><h5>Custom Routes</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Routing-Properties/"><h5>Routing Properties</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Surface-Controllers/"><h5>Surface Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Umbraco-API-Controllers/"><h5>Umbraco API Controllers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Searching/"><h4>Searching</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Searching/Examine/"><h5>Examine</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Events/"><h4>Events</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Events/EditorModel-Events/"><h5>EditorModel Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MemberService-Events/"><h5>MemberService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentService-Events/"><h5>ContentService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentTypeService-Events/"><h5>ContentTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/DataTypeService-Events/"><h5>DataTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/FileService-Events/"><h5>FileService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/LocalizationService-Events/"><h5>LocalizationService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MediaService-Events/"><h5>MediaService Events</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Management/"><h4>Management</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Management/Models/"><h5>Models</h5></a></li> <li class=""><a href="/documentation/Reference/Management/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Plugins/"><h4>Plugins</h4></a> </li> <li class=""> <a href="/documentation/Reference/Cache/"><h4>Cache</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Cache/Application-Cache/"><h5>Application Cache</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Examples/"><h5>Examples</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/ICacheRefresher/"><h5>ICacheRefresher</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Updating-Cache/"><h5>Updating Cache</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Security/"><h4>Security</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Security/Authenticate-with-Active-Directory/"><h5>Authenticate with Active Directory</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Auto-linking/"><h5>Auto linking</h5></a></li> <li class=""><a href="/documentation/Reference/Security/BackOfficeUserManager-and-Notifications/"><h5>BackOfficeUserManager and Notifications</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Custom-password-check/"><h5>Custom password check</h5></a></li> <li class=""><a href="/documentation/Reference/Security/External-login-providers/"><h5>External login providers</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Reset-admin-password/"><h5>Reset admin password</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-hardening/"><h5>Security hardening</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-settings/"><h5>Security settings</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Sensitive-data-on-members/"><h5>Sensitive data on members</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Serverside-sanitizing/"><h5>Serverside sanitizing</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Setup-Umbraco-for-a-Fips-Server/"><h5>Setup Umbraco for a Fips Server</h5></a></li> <li class=""><a href="/documentation/Reference/Security/SSL-HTTPS/"><h5>SSL HTTPS</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Common-Pitfalls/"><h4>Common Pitfalls</h4></a> </li> <li class=""> <a href="/documentation/Reference/Angular/"><h4>Angular</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Angular/Directives/"><h5>Directives</h5></a></li> <li class=""><a href="/documentation/Reference/Angular/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/API-Documentation/"><h4>API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Debugging/"><h4>Debugging</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Reference/Language-Variation/"><h4>Language Variation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Mapping/"><h4>Mapping</h4></a> </li> <li class=""> <a href="/documentation/Reference/Notifications/"><h4>Notifications</h4></a> </li> <li class=""> <a href="/documentation/Reference/Scheduling/"><h4>Scheduling</h4></a> </li> <li class=""> <a href="/documentation/Reference/Using-Ioc/"><h4>Using Ioc</h4></a> </li> <li class=""> <a href="/documentation/Reference/Configuration/"><h4>Configuration</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration/BasicAuthSettings/"><h5>BasicAuthSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ConnectionStringsSettings/"><h5>ConnectionStringsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentDashboard/"><h5>ContentDashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentSettings/"><h5>ContentSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DataTypes/"><h5>DataTypes</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DebugSettings/"><h5>DebugSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ExceptionFilterSettings/"><h5>ExceptionFilterSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/GlobalSettings/"><h5>GlobalSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/HostingSettings/"><h5>HostingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ImagingSettings/"><h5>ImagingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/InstallDefaultDataSettings/"><h5>InstallDefaultDataSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/KeepAliveSettings/"><h5>KeepAliveSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/LoggingSettings/"><h5>LoggingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/MaximumUploadSizeSettings/"><h5>MaximumUploadSizeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ModelsBuilderSettings/"><h5>ModelsBuilderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/NuCacheSettings/"><h5>NuCacheSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PackageMigrationSettings/"><h5>PackageMigrationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PluginsSettings/"><h5>PluginsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RequestHandlerSettings/"><h5>RequestHandlerSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RichTextEditorSettings/"><h5>RichTextEditorSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeMinificationSettings/"><h5>RuntimeMinificationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeSettings/"><h5>RuntimeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/SecuritySettings/"><h5>SecuritySettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ToursSettings/"><h5>ToursSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/TypeFinderSettings/"><h5>TypeFinderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/UnattendedSettings/"><h5>UnattendedSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/WebRoutingSettings/"><h5>WebRoutingSettings</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/"><h3>Tutorials</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Tutorials/Creating-Basic-Site/"><h4>Creating Basic Site</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Document-Types/"><h5>Document Types</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Your-First-Template-and-Content-Node/"><h5>Creating Your First Template and Content Node</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/CSS-And-Images/"><h5>CSS And Images</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Displaying-the-Document-Type-Properties/"><h5>Displaying the Document Type Properties</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-1/"><h5>Creating Master Template Part 1</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-2/"><h5>Creating Master Template Part 2</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Setting-The-Navigation-Menu/"><h5>Setting The Navigation Menu</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Articles-Parent-and-Article-Items/"><h5>Articles Parent and Article Items</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Adding-Language-Variants/"><h5>Adding Language Variants</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Conclusions-Where-Next/"><h5>Conclusions Where Next</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Custom-Dashboard/"><h4>Creating a Custom Dashboard</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Property-Editor/"><h4>Creating a Property Editor</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multilanguage-Setup/"><h4>Multilanguage Setup</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Starter-kit/"><h4>Starter kit</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Starter-kit/Lessons/"><h5>Lessons</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Editors-Manual/"><h4>Editors Manual</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Getting-Started-With-Umbraco/"><h5>Getting Started With Umbraco</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Working-with-Content/"><h5>Working with Content</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Version-Management/"><h5>Version Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Media-Management/"><h5>Media Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Tips-and-Tricks/"><h5>Tips and Tricks</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Add-Google-Authentication/"><h4>Add Google Authentication</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Connecting-Umbraco-Forms-and-Zapier/"><h4>Connecting Umbraco Forms and Zapier</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-an-XML-Site-Map/"><h4>Creating an XML Site Map</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-and-distributing-a-package/"><h4>Creating and distributing a package</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Custom-Views-for-Blocklist/"><h4>Creating Custom Views for Blocklist</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Tables-for-Umbraco-with-PetaPoco/"><h4>Creating Tables for Umbraco with PetaPoco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Custom-Error-Pages/"><h4>Custom Error Pages</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Members-Registration-And-Logins/"><h4>Members Registration And Logins</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multisite-Setup/"><h4>Multisite Setup</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Porting-Packages-V8/"><h4>Porting Packages V8</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/"><h3>Add ons</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Add-ons/UmbracoForms/"><h4>UmbracoForms</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Installation/"><h5>Installation</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Editor/"><h5>Editor</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Developer/"><h5>Developer</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Deploy/"><h4>Umbraco Deploy</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Get-Started-with-Deploy/"><h5>Get Started with Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Installing-Deploy/"><h5>Installing Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deployment-Workflow/"><h5>Deployment Workflow</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deploy-Settings/"><h5>Deploy Settings</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Upgrades/"><h5>Upgrades</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Troubleshooting/"><h5>Troubleshooting</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Extending/"><h5>Extending</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/The-Licensing-model/"><h4>The Licensing model</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Plumber/"><h4>Umbraco Plumber</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Approval-Groups/"><h5>Approval Groups</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Dashboards-and-Buttons/"><h5>Dashboards and Buttons</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Email-Templates/"><h5>Email Templates</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Events/"><h5>Events</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Installing-Plumber/"><h5>Installing Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Licensing/"><h5>Licensing</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Notifications-and-Reminders/"><h5>Notifications and Reminders</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Upgrading-Plumber/"><h5>Upgrading Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Content-App/"><h5>Workflow Content App</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-History/"><h5>Workflow History</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Settings/"><h5>Workflow Settings</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Contribute/"><h3>Contribute</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Contribute/Adding-Metadata/"><h4>Adding Metadata</h4></a> </li> <li class=""> <a href="/documentation/Contribute/Code-samples/"><h4>Code samples</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/DocsTemplates/"><h4>DocsTemplates</h4></a> </li> <li class=""> <a href="/documentation/Contribute/File-Naming-Conventions/"><h4>File Naming Conventions</h4></a> </li> <li class=""> <a href="/documentation/Contribute/How-to-add-a-new-version/"><h4>How to add a new version</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Issues/"><h4>Issues</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Markdown-Conventions/"><h4>Markdown Conventions</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Pull-Requests/"><h4>Pull Requests</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Style-Guide/"><h4>Style Guide</h4></a> <ul class="level-3 "> </ul> </li> </ul> </li> </ul> </details> </nav> </div> </div> </div> <div class="main-area"> <div class="main-content"> <div class="content-wrapper"> <div> <div class="utilities"> <ul id="breadcrumb"> <li><a href="/">Our</a></li> <li><a href="/documentation/">Documentation</a></li> <li><a href="/documentation/Fundamentals/">Fundamentals</a></li> <li><a href="/documentation/Fundamentals/Data/">Data</a></li> <li><a href="/documentation/Fundamentals/Data/Defining-content/">Defining content</a></li> </ul> </div> </div> <div style="width: 100%;" class="alertbar__red"> <h1 style="color: black; font-size: 50px; text-align: center; line-height: 50px; text-decoration: underline;">We have moved!</h1> <p style="font-size:20px; text-align: center; line-height: 50px;">You are currently looking at documentation for Umbraco 8 and older versions. <br> <span>An automated guess is that <a href="https://docs.umbraco.com/umbraco-cms/fundamentals/data/defining-content/">docs.umbraco.com/umbraco-cms/fundamentals/data/defining-content/</a> could be the link to the new documentation for Umbraco 9 and newer versions.</span> </p> </div> <div class="search-big"> <div class="textSearch"> <input type="search" class="docs-search-input" required placeholder="Search for documentation"> <label for="search">Search for documentation</label> </div> </div> <ul class="search-all-results docs-search-listing"></ul> <div id="markdown-docs" class="docs-default-listing markdown-syntax"> <style> #markdown-docs .anchorjs-link { color: #ff6e00 !important; font-size: 20px !important; text-decoration: none !important; } #markdown-docs a.offset-anchor { visibility: hidden; position: relative; top: -100px; display: block; } </style> <script type="text/javascript" src="/scripts/anchorjs/anchorjs.custom.js"></script> <script type="text/javascript"> $(document).ready(function () { anchors.options = { placement: 'left', visible: "hover", anchorCreated: function (e) { var id = $(e).attr('id'); //clear it's id since we'll be creating a custom anchor point with an offset $(e).removeAttr("id"); $(e).addClass("anchorjs-heading"); $(e).prepend("<a class='offset-anchor' id='" + id + "'></a>"); } }; anchors.add('.markdown-syntax h1, .markdown-syntax h2, .markdown-syntax h3, .markdown-syntax h4, .markdown-syntax h5, .markdown-syntax h5'); var element = $(window.location.hash); if (element.length === 1) { setTimeout(function () { //hightlight it element.closest(".anchorjs-heading").css("color", "#ff6e00"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "#ff6e00"); }, 100); } $("#markdown-docs .anchorjs-link").click(function () { if (element.length === 1) { //un hightlight it element.closest(".anchorjs-heading").css("color", "inherit"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "inherit"); } }); }); </script> <aside> <div class="info-box docs-version-panel"> <dl> <dt>Versions</dt> <dd class="current-version selected-version"> 8.0.0 - 9.2.0 </dd> <dd class=" "> <a href='/Documentation/Fundamentals/Data/Defining-content/index-v7'>7.0.0 +</a> </dd> </dl> </div> </aside> <h1 id="defining-content">Defining content</h1> <p><em>Here you'll find an explanation of how content is defined in v8.</em></p> <p>Before a piece of content can be created it needs to be defined. That is why, when opening a blank installation of Umbraco, it is not possible to create content in the <strong>Content</strong> section. All content needs a blueprint that holds information about what kind of data can be stored on the content node or which editors are used. Additionally, it also needs information on how it is organized, where in the structure it is allowed, and so forth. This blueprint or definition is called a Document Type.</p> <h2 id="what-is-a-document-type">What is a Document Type?</h2> <p>A Document Type contains fieldsets (or groups) where you can apply rules about where the content can be created, allowed template(s), backoffice icons, etc.</p> <p>Document Types can define entire pages or more limited content that can be reused on other nodes ie. a Search Engine Optimization (SEO) group. This means that you are in complete control of what type of content can be created where.</p> <p>Document Types define what an end user sees and can interact with when they are working in the Umbraco backoffice. For a "Blog post" Document Type containing a thumbnail, a name, and an author image, it needs to be defined in the Document Type. All blog posts using the "Blog post" Document Type, will allow the end user to fill in a thumbnail, author name, and an author image.</p> <h3 id="properties">Properties</h3> <p>Each field on a Document Type is called a property. The property is given a name, an alias (used to output the properties contained in a template), and an editor. The editor determines what type of data the property will store and the input method. There is a wide range of default property editors available (Textstring, Richtext, Media Picker, and so forth) and you can customize additional editors.</p> <p>Some editors require configuration, a configured editor is saved as a Data Type and can be re-used for multiple properties and document types. These can be seen in the <strong>Settings</strong> section under <strong>Data Types</strong>.</p> <h2 id="creating-a-document-type">Creating a Document Type</h2> <p>A Document Type is created using the Document Type editor in the <strong>Settings</strong> section.</p> <p>Go to the <strong>Settings</strong> section in the backoffice. On the <strong>Document Types</strong> node click the menu icon (•••) to bring up the context menu. Here choose <strong>Document Type with Template</strong>. This will create a new Document Type with a template. The Template can be found under <strong>Templates</strong> in the <strong>Settings</strong> section that will be assigned as the default template for the Document Type.</p> <p><img src="images/v8Screenshots/createDoctype.png" alt="Creating a Document Type" /></p> <p>You can also choose to create a <strong>Document Type</strong> without a template and create <strong>Folders</strong> to organize your Document Types.</p> <p>You can also use <strong>Composition</strong> to create a new Document Type. Compositions allow you to inherit properties from other groups. When using a mixed setup, you can take advantage of nesting and use compositions by visiting the Structure group. A checklist like this should appear:</p> <p><img src="images/v8Screenshots/compositions.png" alt="Creating a Compositions" /></p> <p>Finally, you can create a Document Type as an <strong>Element Type</strong> which can be used to build Block Grid and Block List editors. Learn more about <a href="#what-is-an-element-type" rel="nofollow">Element Types</a> below.</p> <h2 id="what-is-an-element-type">What is an Element Type?</h2> <p>An Element Type is a Document Type without a template containing schema configurations for repeating a set of properties. These are for defining schema in the Block List Editor, Nested Content, Block Grid Editor, or other Element Type based editors. Element Types cannot be used to create content that resides in the Content tree. When you create an Element type, it automatically sets the <strong>Is Element Type</strong> flag to <strong>True</strong> on the <strong>Permissions</strong> tab.</p> <p><img src="images/Element-Type.png" alt="Element Type" /></p> <p>Element Types are created using the same workflow as regular Document Types but usually contain fewer properties. You can also create Element Types as part of configuring a Block Grid or Block List Data Type.</p> <h3 id="exportingimporting-the-document-type">Exporting/Importing the Document Type</h3> <p>You can export document types from a project/installation and import them into another project/installation. Go to the <strong>Settings</strong> section, right-click the <strong>Document type</strong>, and select <strong>Export</strong>. When you click on the <strong>Export</strong> button, the Document Type is saved as *.udt file.</p> <p><img src="images/v8Screenshots/export-document-type.png" alt="Exporting a Document Type" /></p> <p>To import a Document Type, go to the <strong>Settings</strong> section, right-click the <strong>Document type</strong>, and select <strong>Import Document Type</strong>. Click on the <strong>Import</strong> button and browse to the Document Type you exported. The <strong>Name</strong> and <strong>Alias</strong> of the Document Type are displayed. Click <strong>Import</strong> to complete the process.</p> <p><img src="images/import-document-type.png" alt="Importing a Document Type" /></p> <div class="note"> <ol> <li>If your Document Type contains compositions or inherits from another Document Type, then you need to export/import the Composition/Document Type too.</li> <li>You cannot export/import document types on Umbraco Cloud.</li> </ol> </div> <h3 id="defining-the-root-node">Defining the root node</h3> <p>First, we're prompted to give the Document Type a name. This first Document Type will be the root node for our content, name it "Home".</p> <p><img src="images/v8Screenshots/homePage.png" alt="Naming a Document Type" /></p> <p><em>Notice that the alias of the Document Type is automatically generated based on the name. If you want to change the alias click the "lock" icon.</em></p> <p>Having a root node lets you quickly query content as you know everything will be under the root node.</p> <p>To set an icon for the Document Type click the document icon in the top left corner. This will open the icon select dialog. Search for <em>Home</em> and select the icon. This icon will be used in the content tree. Choosing appropriate icons for your content nodes is a good way to give editors a better overview of the content tree.</p> <p><img src="images/v8Screenshots/docTypeIcon.png" alt="Choosing an icon for the Document Type" /></p> <p>Go to the <strong>Permissions</strong> tab and tick the <strong>Allow as root</strong> toggle and save the Document Type by clicking save in the bottom right corner.</p> <p><img src="images/v8Screenshots/docTypePermissions.png" alt="Allow at root" /></p> <h3 id="creating-the-root-node">Creating the root node</h3> <p>Now go to the <strong>Content section</strong>, click on the menu icon next to <strong>Content</strong> and Select the Home Document Type. We'll name it "Home" and click the <strong>Save and Publish</strong> button.</p> <p><img src="images/v8Screenshots/createHomepage.png" alt="First content created" /></p> <p>As we haven't created our properties, all we can see on the "Home" node is the Properties tab. This tab contains the default properties that are available on all content nodes in Umbraco.</p> <p>Let's add some properties of our own.</p> <h3 id="groups-and-properties">Groups and properties</h3> <p>Go to the <strong>Settings section</strong>, expand <strong>Document Types</strong> by clicking the arrow to the left, and select the <strong>Home</strong> Document Type.</p> <h4 id="keyboard-shortcuts">Keyboard Shortcuts</h4> <p>Keyboard shortcuts are available when you are working with the Document Type editor. To see which shortcuts are available, click <strong>ALT + SHIFT + K</strong>.</p> <h4 id="adding-groups">Adding groups</h4> <p>Before we start adding properties to the Document Type we need to create a group to hold the property.</p> <p>Click <strong>Add group</strong> and name the group "Content".</p> <p><img src="images/v8Screenshots/createGroup_new.png" alt="Creating groups" /></p> <p><em>If you have multiple groups and/or properties you can order them with drag and drop or by entering a numeric sort order value. This is done by clicking <strong>Reorder</strong>.</em></p> <p>To convert a group to a tab, see the <a href="../Adding-Tabs/index#convert-a-group-to-a-tab" rel="nofollow">Convert a group to a tab</a> section in the <a href="../Adding-Tabs/" rel="nofollow">Using Tabs</a> article.</p> <h4 id="adding-properties">Adding properties</h4> <p>Now that we have created a group we can start adding properties. Let's add a Rich Text editor to the Content group.</p> <p>Click the <strong>Add property</strong> link in the Content group. This opens the property settings dialog. Here you can set the metadata for each property (name, alias, description), choose which Data Type/property editor to use, and add validation if needed.</p> <p>Give the property a name, the name will be shown to the editor to make it relevant and understandable. Notice the alias is automatically generated based on the name. We'll name this "Body Text".</p> <p><img src="images/v8Screenshots/addproperty_new.png" alt="Adding a property" /></p> <h5 id="property-editors">Property editors</h5> <p>Clicking <strong>Select editor</strong> will open the Select editor dialog. Here, you can choose between all the available editors on the <strong>Create a new configuration</strong> tab. This will create a new configuration or already configured editors in the <strong>Available configurations</strong> tab. To make it easier to find what you need use the search field to filter by typing "Rich". Filtering will display configured properties first (under <strong>Available configurations</strong>) and all available editors under that.</p> <p>Select the <strong>Rich Text editor</strong> under <strong>Create new</strong>.</p> <p><img src="images/v8Screenshots/selectEditor_new.png" alt="Choosing the Rich Text editor" /></p> <p>This will let you configure the editor settings - the Rich Text editor for this property.</p> <div class="note"><p>The name of the Data Type is based on the name of the Document Type, the name of the property, and the property editor. Flor example: <em>Home - Body Text - Rich Text editor</em>.</p> </div> <p>Let's rename it to "Basic Rich Text editor" and only select the most necessary options.</p> <ul> <li><code>bold</code></li> <li><code>italic</code></li> <li><code>alignLeft</code></li> <li><code>alignCenter</code></li> <li><code>link</code></li> <li><code>umbMediaPicker</code></li> </ul> <p>When you are happy with the settings click <strong>Submit</strong>.</p> <p>Selecting the <strong>Mandatory</strong> toggle makes the property mandatory and the content cannot be saved if no value is entered (in this case, the Richtext editor). You have the option to add additional validation by selecting a predefined validation method under the <strong>Custom validation</strong> dropdown (such as email, number, or URL). Or by selecting a custom validation and adding a regular expression.</p> <p>Submit the property and save the Document Type. If you go to the <strong>Content section</strong> and click on the Home node you will now see the Content group with the Body Text property.</p> <h3 id="defining-child-nodes">Defining child nodes</h3> <p>Next up we'll create a text page Document Type that will be used for subpages on the site.</p> <p>Go back to the <strong>Settings section</strong> and create a new Document Type and name it "Text Page". Add a group called "Content" and this time we'll add two properties. First, make a property called Summary using the <strong>Textarea</strong> editor and secondly create a property called "Body Text" and reuse the <strong>Rich Text Editor</strong> Data Type.</p> <h3 id="creating-child-nodes">Creating child nodes</h3> <p>Before creating a Text Page in <strong>Content</strong> section, allow the Text Page Document Type to be created as a child node to the Home node. Select the Home Document Type and go to the <strong>Permissions</strong> group. Click <strong>Add child</strong> and select Text Page.</p> <p><img src="images/v8Screenshots/setPagePermissions.png" alt="Allowing child nodes" /></p> <p>Go to the <strong>Content</strong> section and click the menu icon (•••) next to the <em>Home</em> node and select the Text page Document Type. We'll name the page "About us". We now have a basic content structure.</p> <p><img src="images/v8Screenshots/createAboutUs.png" alt="Basic content structure" /></p> <p>Document Types are flexible and can be used for defining pieces of reusable content or an entire page, to acting as a container or repository.</p> <h3 id="more-information">More information</h3> <ul> <li><a href="../../Design/Rendering-Content/" rel="nofollow">Rendering Content</a></li> <li><a href="../Data-Types/" rel="nofollow">Customizing Data Types</a></li> </ul> <h3 id="related-services">Related Services</h3> <ul> <li><a href="../../../Reference/Management/Services/ContentService/" rel="nofollow">ContentService</a></li> <li><a href="../../../Reference/Management/Services/ContentTypeService/" rel="nofollow">ContentTypeService</a></li> </ul> <h3 id="tutorials">Tutorials</h3> <ul> <li><a href="../../../Tutorials/Creating-Basic-Site/" rel="nofollow">Creating a basic website with Umbraco</a></li> </ul> <h3 id="umbraco-learning-base-channel"><a href="https://www.youtube.com/channel/UCbGfwSAPflebnadyhEPw-wA" rel="nofollow">Umbraco Learning Base Channel</a></h3> <ul> <li><a href="https://www.youtube.com/playlist?list=PLgX62vUaGZsG98vy9HWuwpU4XVnbIAnHK" rel="nofollow">Playlist: Document Types in Umbraco</a></li> </ul> </div> </div> </div> </div> </div> <script type="text/template" class="search-item-docs"> <li> <a href="{{ url }}"> <div class="type-icon"> <i class="icon-Book-alt"></i> </div> <div class="type-context"> <div class="type-name"> {{ name }} </div> <div class="type-description"> {{ body }} </div> </div> </a> </li> </script> </div> </div> <footer> <div class="container is-narrow-tablet"> <div class="row"> <div class="col-xs-12"> <p><a href="/code-of-conduct">Code Of Conduct</a> - <a href="/privacy-policy">Privacy Policy</a></p> <p> </p> Our.umbraco.com is the community mothership for <a href="https://umbraco.com" target="_blank" rel="noopener noreferrer">Umbraco</a>, the open source asp.net cms. With a friendly forum for all your questions, a comprehensive documentation and a ton of packages from the community. </div> </div> </div> </footer> </div>  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.13.1/jquery.validate.min.js" type="text/javascript"></script><script src="https://ajax.aspnetcdn.com/ajax/mvc/4.0/jquery.validate.unobtrusive.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Converter.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Editor.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Sanitizer.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mustache.js/0.8.1/mustache.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.js" type="text/javascript"></script><script src="/DependencyHandler.axd?s=L2Fzc2V0cy9qcy9qcXVlcnkuYWpheGZpbGV1cGxvYWQuanM7L2Fzc2V0cy9qcy9qcXVlcnkuc2Nyb2xseS5qczsvYXNzZXRzL2pzL2xvZGFzaC5taW4uanM7L2Fzc2V0cy9qcy9jb21tdW5pdHkuanM7L2Fzc2V0cy9qcy9hcHAubWluLmpzOy9hc3NldHMvanMvZWRpdG9yLm1pbi5qczs&t=Javascript&cdv=25020301" type="text/javascript"></script> </body> </html>

CINXE.COM

Defining content - Our Umbraco