Skip to content

Commit 32ed96d

Browse files
authored
Merge pull request #6497 from iOvergaard/v14/docs/default-document-types
docs: describe default document types in more detail
2 parents f8acd39 + 2f5b3bf commit 32ed96d

File tree

2 files changed

+39
-31
lines changed

2 files changed

+39
-31
lines changed

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

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,35 @@
22

33
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.
44

5-
![Create doc type](/14/umbraco-cms/fundamentals/data/images/CreateDoctype.png)
5+
![Create Document Type](/14/umbraco-cms/fundamentals/data/images/CreateDoctype.png)
6+
7+
## Document type
8+
9+
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.
610

711
## Document type with template
812

913
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.
1014

11-
## Document type
15+
## Element Type
16+
17+
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.
18+
19+
Element Types cannot be used to create content that resides in the Content tree. When you create an Element type, it automatically sets the **Is Element Type** flag to **True** on the **Permissions** tab.
20+
21+
![Element type](/14/umbraco-cms/fundamentals/data/images/element-type.png)
22+
23+
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.
24+
25+
## Folder
1226

13-
Creating a Document Type (without a template) is about defining the content structure and fields that can be used across different content items. You might use document types without templates for creating consistent, structured content that doesn't require a predefined page layout. For example blog posts or product listings.
27+
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.
1428

1529
## Compositions
1630

17-
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.
31+
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.
1832

19-
When using a mixed setup, you can take advantage of nesting and use compositions by clicking on "**Compositions**..." option.
33+
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.
2034

2135
![Create group](/14/umbraco-cms/fundamentals/data/images/createGroup_new.png)
2236
{% hint style="warning" %}
@@ -25,13 +39,3 @@ If you create 2 compositions that contain some common properties it is only poss
2539

2640
![Composition](/14/umbraco-cms/fundamentals/data/images/composition.png)
2741
{% endhint %}
28-
29-
## Element Type
30-
31-
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.
32-
33-
Element Types cannot be used to create content that resides in the Content tree. When you create an Element type, it automatically sets the **Is Element Type** flag to **True** on the **Permissions** tab.
34-
35-
![Element type](/14/umbraco-cms/fundamentals/data/images/element-type.png)
36-
37-
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.

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

Lines changed: 20 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,36 +2,40 @@
22

33
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.
44

5-
![Create doc type](/14/umbraco-cms/fundamentals/data/images/CreateDoctype.png)
5+
![Create Document Type](/15/umbraco-cms/fundamentals/data/images/CreateDoctype.png)
6+
7+
## Document type
8+
9+
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.
610

711
## Document type with template
812

913
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.
1014

11-
## Document type
15+
## Element Type
1216

13-
Creating a Document Type (without a template) is about defining the content structure and fields that can be used across different content items. You might use document types without templates for creating consistent, structured content that doesn't require a predefined page layout. For example blog posts or product listings.
17+
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.
1418

15-
## Compositions
19+
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.
1620

17-
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.
21+
![Element type](/15/umbraco-cms/fundamentals/data/images/element-type.png)
1822

19-
When using a mixed setup, you can take advantage of nesting and use compositions by clicking on "**Compositions**..." option.
23+
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.
2024

21-
![Create group](/14/umbraco-cms/fundamentals/data/images/createGroup_new.png)
22-
{% hint style="warning" %}
25+
## Folder
2326

24-
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 checkmarking the `Hide unavailable options`.
27+
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.
2528

26-
![Composition](/14/umbraco-cms/fundamentals/data/images/composition.png)
27-
{% endhint %}
29+
## Compositions
2830

29-
## Element Type
31+
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.
3032

31-
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.
33+
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.
3234

33-
Element Types cannot be used to create content that resides in the Content tree. When you create an Element type, it automatically sets the **Is Element Type** flag to **True** on the **Permissions** tab.
35+
![Create group](/15/umbraco-cms/fundamentals/data/images/createGroup_new.png)
36+
{% hint style="warning" %}
3437

35-
![Element type](/14/umbraco-cms/fundamentals/data/images/element-type.png)
38+
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`.
3639

37-
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.
40+
![Composition](/15/umbraco-cms/fundamentals/data/images/composition.png)
41+
{% endhint %}

0 commit comments

Comments
 (0)