Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: describe default document types in more detail #6497

Merged
merged 12 commits into from
Oct 8, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,35 @@

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

## Document type

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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

## 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.

## Document type
## Element Type

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

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.

![Element type](/14/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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

## Folder

A Folder is 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 that is displayed on the front end of your website.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

## 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 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 that are shared across multiple Document Types, such as metadata fields or social media links.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

When using a mixed setup, you can take advantage of nesting and use compositions by clicking on "**Compositions**..." option.
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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

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

![Composition](/14/umbraco-cms/fundamentals/data/images/composition.png)
{% endhint %}

## 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.

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.

![Element type](/14/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.
Original file line number Diff line number Diff line change
Expand Up @@ -2,36 +2,40 @@

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

## Document type

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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

## 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.

## Document type
## Element Type

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.
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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

## Compositions
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.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

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

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

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

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`.
A Folder is 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 that is displayed on the front end of your website.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

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

## Element Type
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 that are shared across multiple Document Types, such as metadata fields or social media links.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

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

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.
![Create group](/15/umbraco-cms/fundamentals/data/images/createGroup_new.png)
{% hint style="warning" %}

![Element type](/14/umbraco-cms/fundamentals/data/images/element-type.png)
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`.
jonat123 marked this conversation as resolved.
Show resolved Hide resolved

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