Merge pull request #6700 from umbraco/document-type

Updated Default Document Types article

Author: eshanrnh

14/umbraco-cms/fundamentals/data/defining-content/default-document-types.md

@@ -6,40 +6,36 @@ 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
+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 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
+Use a Document Type without a template for structured, reusable content like metadata schemas, settings, or components such as product details and author profiles.
 
-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.
+## Document Type with Template
 
-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.
+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.
 
-<figure><img src="../../../.gitbook/assets/image.png" alt="Element type"><figcaption><p>Element type</p></figcaption></figure>
+Use a Document Type with a template for pages like blog posts, landing pages, or services that appear directly on the website.
 
-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.
+## Element Type
 
-## Folder
+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.
 
-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.
+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
+![Element Type](../../../.gitbook/assets/image.png)
 
-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.
+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.
 
-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.
+## Folder
 
-![Create group](../images/createGroup\_new.png)
+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.
 
-{% 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`.
+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.
 
-<img src="../images/composition.png" alt="Composition" data-size="original">
-{% endhint %}
+Folders are a powerful tool to keep your Document Types organized and your backoffice tidy.

15/umbraco-cms/fundamentals/data/defining-content/default-document-types.md

@@ -1,41 +1,41 @@
+---
+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" %}
+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.
 
-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`.
+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.
 
-![Composition](/15/umbraco-cms/fundamentals/data/images/composition.png)
-{% endhint %}
+Folders are a powerful tool to keep your Document Types organized and your backoffice tidy.