Kentico CMS 7.0 Developer's Guide

Document type properties

Document type properties

Previous topic Next topic Mail us feedback on this topic!  

Document type properties

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Document type properties can be accessed in Site Manager -> Development -> Document types -> Edit (Edit) Document type.




The Document types properties user interface consists of the following tabs: General, Fields, Form, Transformations, Queries, Child types, Sites, E-commerce, Alternative forms, Search fields, Documents and Versions.


General tab


The general properties of a document type define its basic characteristics as shown below:



Document type display name

The name of the document type displayed in the administration and content editing interface.

Document type code name

Sets a namespace prefix and unique name that serves as an identifier for the document type, for example in selectors or the API.

Table name

Displays the name of the database table used to store coupled data for documents of this type, i.e. the content of its specific fields.

Inherit fields from document type

If a document type is selected and saved, the definitions of its fields will be loaded and added to the current document type. These fields can be viewed and modified on the Fields tab.

Document type icons

Allows you to upload custom icons that will be used to represent the document type in various parts of the system.

New document settings

New page

URL of the page that will be used when creating new documents of this type.

Show template selection

Indicates if users will be required to select a page template when creating a new document of this type.

Root page template category

May be used to limit the page template options available for documents of this type to a specific sub-section of the template catalog. When creating new documents of the given type, users can only choose from the templates located under the specified category or in its child categories.

Default page template

Sets the page template used by default when the document is created. If no page template is specified, new documents will inherit the template of their parent by default.

Editing pages settings

(these should only be specified if you do not wish to use the system's default editing pages)

Editing page

URL of the editing page that will be used when the document is displayed in editing mode via the Page tab.

Editing form

URL of the editing page that will be used when the document is displayed in editing mode on the Form tab.

Preview page

URL of the page that will be used when the document is displayed in preview mode.

List page

URL of the editing page that will be used when the document is displayed in list mode.

Advanced settings

Use publish from/publish to

Indicates if the Publish from/to fields should be offered on the Form tab for documents of this type. These may be used to schedule the page represented by the document to be published on the live site on a specific date and time, or shown only during a limited time interval.

Behaves as Page (menu item) type

Indicates if the document type should behave similar to the default Page (menu item) document type. The default view mode for such a document type is the Page tab. Viewer web parts are automatically set to display child documents if the path is not configured and the document does not inherit its parent template by default.




Fields tab


The Fields tab contains a field editor that allows you to manage the data fields (columns) of the document type. Using the tab, you can add a New attribute (NewAttribute), New system attribute (AddNewSystemAttribute) or New category (NewCategory) and you can Save (Save), Delete (Delete), Move Up (Up) and Move Down (Down) the fields. You can also define which fields should be used as the source for the default name and alias of new documents of this type. This can be done via the drop-down lists below the field listbox.


For a practical example of the use of the Fields tab, please refer to the File Management -> Document attachments -> Example: Grouped attachment topic in the Content management section of this guide.







Please note


If a document type is inherited from another document type, the inherited fields are grayed out and must be edited in the parent type. Any changes made to the fields in the parent type are automatically reflected in the child type.



Form tab


The Form tab allows you to create a custom form layout that will be used for adding and editing data items. You can use the WYSIWYG editor and you can also insert a field label, input, validation label and submit button. This functionality can be enabled by checking the Use custom form layout checkbox. Please note that if no custom layout is available, the default layout will be used.


More details about the use of the Form tab can be found in Forms -> Defining custom form layout in the Modules section or in Custom fields visibility -> Use in custom form layout in the Development -> Membership, permissions and security section of this guide.




Transformations tab


On the Transformations tab, you can see the list of all available transformations added to the given document type. New transformations can be added using NewTransformation_6.0 New transformation or NewHierarchicalTransformation New hierarchical transformation. The transformations can also be Edited (Edit) or Deleted (Delete) here.


More information about transformations can be found in this chapter in the Transformations, Adding custom functions to transformations, Writing transformations and Hierarchical transformations topics.




Queries tab


The Queries tab displays a list of all available SQL queries added to the particular document type. You can Edit (Edit) or Delete (Delete) items from the list. New queries can be added using NewRecord New query.


More information about the use of SQL queries can be found in the Data layer chapter in the API programming and Kentico CMS internals section of this guide.




Child types tab


The Child types tab allows you to select document types (child document types) that can be placed under documents of the given type. And vice versa, you can define under which document types (parent document types) documents of the given document type can be placed.




Sites tab


The Sites tab enables you to select sites where the given document type can be used. If you need to add a site, click the Add sites button and select it from the list of available sites. To remove a site, check the checkbox next to the site you would like to remove and click the Remove selected button.




E-commerce tab


The E-commerce tab allows you to specify whether the current document type should be offered as a product type or section type.


Document's relation to product


Document type represents a product type - indicates if the document type represents a product type.

Document type represents a product section - indicates if the document type represents a product section.


Fields mapping


The section is available only if the currently edited document type is set to represent a product type. You can optionally select fields here that will be automatically populated with values from the specified SKU fields.


New product creation


The section is available only if the currently edited document type is set to represent a product type.


Default department - can be used to specify a department where, by default, products created on the basis of the given product type belong.

This document type represents - can be used to choose default representation for the product.

Create SKU automatically when a new document of this type is created - indicates if an SKU should be created automatically when a new document of this type is created.




Alternative forms


The Alternative forms tab allows management of alternative forms for the selected document type. New forms can be created using the CreateNewForm Create new form. You can also Edit (Edit) or Delete (Delete) the existing alternative forms listed in the table.


More information about alternative forms can be found in the Alternative forms chapter in the Modules section of this guide.




Search fields


On the Search fields tab, you can define how data stored in the document type will be indexed by the Smart search module. In the top part, you can specify how documents of the given type will be displayed in search results. Lines of the table in the bottom part of the tab represent document fields defined on the Fields tab, while columns correspond to Smart search properties. Please note that you can use the Set automatically link to have the table configured automatically.


For more details on how the content of documents of this document type and of the whole website is searched, please refer to the Smart search chapter.






By switching to the Documents tab, you can view a list of all documents of the currently edited document type. Using the Site drop-down list, you can choose whether to display all documents of the type in the system or only on a particular site. The Document name fields allow you to search for documents that match the entered parameters.




Versions tab


On the Versions tab, you can see all versions of the currently edited document type. You can find more details in the Development -> Object versioning section.