From 96fc70fa53979699b4aa02feb3453d092e5bb7d3 Mon Sep 17 00:00:00 2001 From: Esha Noronha Date: Fri, 22 Nov 2024 16:03:48 +0100 Subject: [PATCH 1/2] Updated Default Document Types article --- .../default-document-types.md | 36 +++++++--------- .../default-document-types.md | 42 +++++++++---------- 2 files changed, 35 insertions(+), 43 deletions(-) diff --git a/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md b/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md index ac9a41ace97..6e07b1a01c6 100644 --- a/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md +++ b/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md @@ -6,40 +6,34 @@ description: >- # Default Document Types +On this page, you will find the default Document Types in Umbraco. If you want to use these Document Types, you can create them in the Settings section. + ![Create Document Type](../images/CreateDoctype.png) ## Document Type -Creating a Document Type (without a template) defines the content structure and fields that can be used across different content items. You might use document types without templates to create consistent, structured content that doesn't require a predefined page layout. For example blog posts or product listings. - -## Document type with template - -Creating document types with templates allows you to define both the content structure and the visual presentation of a particular type of content item. It ensures a consistent and cohesive look and feel across your website while also enabling structured content management. This approach helps separate content from design, making it easier to manage and update your website's content and appearance independently through templates. - -## Element Type +A Document Type defines the content structure and fields that can be used across different content items. When creating a Document Type without a template, you focus solely on structured content without tying it to a specific design or layout. This is ideal for content that doesn’t require direct front-end rendering, such as reusable blocks or items managed within a headless CMS setup. -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, Block Grid Editor, or other Element Type-based editors. +Use a Document Type without a template for structured, reusable content like metadata schemas, settings, or components such as product details and author profiles. -Element Types cannot be used to create content in the Content tree. When you create an Element type, it automatically sets the **Is Element Type** flag to **True** in the **Settings** tab. +## Document Type with Template -
Element type

Element type

+A Document Type with a Template combines the content structure with a predefined visual presentation. This approach links your structured content with a specific page design, ensuring a consistent and cohesive look and feel across your site. It allows you to manage content and its appearance separately, which makes updates more efficient. -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. +Use a Document Type with a template for pages like blog posts, landing pages, or services that appear directly on the website. -## Folder +## Element Type -Folders are a special type of Document Type that can be used to organize content in the Content tree. Folders can contain other content items, such as other folders or content nodes. They are useful for organizing content in a logical hierarchy, making it easier to manage and navigate your website's content. They cannot be used to create content displayed on the front end of your website. +An Element Type is a Document Type *without a template* designed for reusabale and repeatable set of properties. These are primarily used in editors like the Block List Editor or Block Grid Editor to create structured, nested content. -## Compositions +Element Types are not part of the Content tree and cannot render directly on the front end. When created, the **Is an Element Type** flag in the **Permissions** tab is automatically set to **True**. -Compositions provide a way to create reusable sets of properties that can be added to one or more Document Types. This can help simplify the management and consistency of content types across your website. Compositions can be used to define common properties shared across multiple Document Types, such as metadata fields or social media links. +![Element Type](../../../.gitbook/assets/image.png) -To get started with compositions, you have to create the needed Document Types as described above. Later you can take advantage of nesting and use compositions by clicking on "**Compositions**..." option on the Document Type editor. Here you will be able to select the Document Types you want to use as compositions for the current Document Type. The fields of the selected compositions will then be available on the current Document Type. +Use an Element Type when defining building blocks for complex page layouts, such as grid blocks or call-to-action sections. They are an essential part of modular content design. -![Create group](../images/createGroup\_new.png) +## Folder -{% hint style="warning" %} -If you create 2 compositions that contain some common properties it is only possible to pick one of the compositions in a Document Type. If preferred, those compositions that cannot be used can be marked as hidden by check marking the `Hide unavailable options`. +A Folder is a special type of Document Type used solely for organizing content within the Content tree. Folders can contain other content items, such as other folders or content nodes. -Composition -{% endhint %} +Use a Folder to logically group related content in your Content tree, such as organizing articles by category or grouping assets for better management. This enhances navigation and keeps your content structure clean. diff --git a/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md b/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md index 83ad32a78d6..06b9dbede90 100644 --- a/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md +++ b/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md @@ -1,41 +1,39 @@ +--- +description: >- + On this page, you will find the default Document Types in Umbraco. If you want + to use these document types, you can create them in the Settings section. +--- + # Default Document Types -On this page, you will find the default Document Types in Umbraco. If you want to use these document types, you can create them in the Settings section. +On this page, you will find the default Document Types in Umbraco. If you want to use these Document Types, you can create them in the Settings section. ![Create Document Type](/15/umbraco-cms/fundamentals/data/images/CreateDoctype.png) -## Document type +## Document Type + +A Document Type defines the content structure and fields that can be used across different content items. When creating a Document Type without a template, you focus solely on structured content without tying it to a specific design or layout. This is ideal for content that doesn’t require direct front-end rendering, such as reusable blocks or items managed within a headless CMS setup. -Creating a Document Type (without a template) defines the content structure and fields that can be used across different content items. You might use document types without templates to create consistent, structured content that doesn't require a predefined page layout. For example blog posts or product listings. +Use a Document Type without a template for structured, reusable content like metadata schemas, settings, or components such as product details and author profiles. -## Document type with template +## Document Type with Template -Creating document types with templates allows you to define both the content structure and the visual presentation of a particular type of content item. It ensures a consistent and cohesive look and feel across your website while also enabling structured content management. This approach helps separate content from design, making it easier to manage and update your website's content and appearance independently through templates. +A Document Type with a Template combines the content structure with a predefined visual presentation. This approach links your structured content with a specific page design, ensuring a consistent and cohesive look and feel across your site. It allows you to manage content and its appearance separately, which makes updates more efficient. + +Use a Document Type with a template for pages like blog posts, landing pages, or services that appear directly on the website. ## Element Type -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, Block Grid Editor, or other Element Type-based editors. +An Element Type is a Document Type *without a template* designed for reusabale and repeatable set of properties. These are primarily used in editors like the Block List Editor or Block Grid Editor to create structured, nested content. -Element Types cannot be used to create content in the Content tree. When you create an Element type, it automatically sets the **Is Element Type** flag to **True** on the **Permissions** tab. +Element Types are not part of the Content tree and cannot render directly on the front end. When created, the **Is an Element Type** flag in the **Permissions** tab is automatically set to **True**. ![Element type](/15/umbraco-cms/fundamentals/data/images/element-type.png) -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. +Use an Element Type when defining building blocks for complex page layouts, such as grid blocks or call-to-action sections. They are an essential part of modular content design. ## Folder -Folders are a special type of Document Type that can be used to organize content in the Content tree. Folders can contain other content items, such as other folders or content nodes. They are useful for organizing content in a logical hierarchy, making it easier to manage and navigate your website's content. They cannot be used to create content displayed on the front end of your website. - -## Compositions - -Compositions provide a way to create reusable sets of properties that can be added to one or more Document Types. This can help simplify the management and consistency of content types across your website. Compositions can be used to define common properties shared across multiple Document Types, such as metadata fields or social media links. - -To get started with compositions, you will first have to create the needed Document Types as described above. Later you can take advantage of nesting and use compositions by clicking on "**Compositions**..." option on the Document Type editor. Here you will be able to select the Document Types you want to use as compositions for the current Document Type. The fields of the selected compositions will hereafter be available on the current Document Type. - -![Create group](/15/umbraco-cms/fundamentals/data/images/createGroup_new.png) -{% hint style="warning" %} - -If you create 2 compositions that contain some common properties it is only possible to pick one of the compositions in a Document Type. If preferred, those compositions that cannot be used can be marked as hidden by check marking the `Hide unavailable options`. +A Folder is a special type of Document Type used solely for organizing content within the Content tree. Folders can contain other content items, such as other folders or content nodes. -![Composition](/15/umbraco-cms/fundamentals/data/images/composition.png) -{% endhint %} +Use a Folder to logically group related content in your Content tree, such as organizing articles by category or grouping assets for better management. This enhances navigation and keeps your content structure clean. From a81280287ae07e8e73fbb1d41b1661463a3b06d5 Mon Sep 17 00:00:00 2001 From: Esha Noronha Date: Thu, 28 Nov 2024 16:29:41 +0100 Subject: [PATCH 2/2] Incoprorated review comment --- .../data/defining-content/default-document-types.md | 6 ++++-- .../data/defining-content/default-document-types.md | 6 ++++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md b/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md index 6e07b1a01c6..d061ca35d66 100644 --- a/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md +++ b/14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md @@ -34,6 +34,8 @@ Use an Element Type when defining building blocks for complex page layouts, such ## Folder -A Folder is a special type of Document Type used solely for organizing content within the Content tree. Folders can contain other content items, such as other folders or content nodes. +The Folder in the Document Types section is used to organize and structure your Document Types within the Settings section. It serves purely as an organizational container, with no impact on the Content section or site functionality. -Use a Folder to logically group related content in your Content tree, such as organizing articles by category or grouping assets for better management. This enhances navigation and keeps your content structure clean. +Use a Folder to create logical groupings, like a folder named **Compositions** to hold all your Composition Document Types. This makes it easier to navigate and manage your Document Types, especially in larger projects. + +Folders are a powerful tool to keep your Document Types organized and your backoffice tidy. diff --git a/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md b/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md index 06b9dbede90..dbf520b95a0 100644 --- a/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md +++ b/15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md @@ -34,6 +34,8 @@ Use an Element Type when defining building blocks for complex page layouts, such ## Folder -A Folder is a special type of Document Type used solely for organizing content within the Content tree. Folders can contain other content items, such as other folders or content nodes. +The Folder in the Document Types section is used to organize and structure your Document Types within the Settings section. It serves purely as an organizational container, with no impact on the Content section or site functionality. -Use a Folder to logically group related content in your Content tree, such as organizing articles by category or grouping assets for better management. This enhances navigation and keeps your content structure clean. +Use a Folder to create logical groupings, like a folder named **Compositions** to hold all your Composition Document Types. This makes it easier to navigate and manage your Document Types, especially in larger projects. + +Folders are a powerful tool to keep your Document Types organized and your backoffice tidy.