OpenCms Documentation

Tab configuration

 Show GitHub edit links  Hide GitHub edit links
In OpenCms since: 7.5 Valid for OpenCms: 11.0.0

The form-based content editor allows editor fields to be grouped in tabs. The fields of which schema elements should be shown in which tabs is configured in the schema definition.

Configuration of tabs

Tabs are configured in the schema definition under xsd:annotations/xsd:appinfo. Use the node <tabs> to configure them. If used without sub-nodes, the tabs are configured automatically by OpenCms. To set up the tabs explicitly according to your needs, use a sub-node <tab> for each of them:

    <tab element="Title" collapse="false" name="General" />
    <tab element="Author" collapse="false" name="AuthorTab" />
    <tab element="Availability" collapse="true" name="Availability" />

In the example, three tabs are defined. Each <tab> element is configured via its attributes as follows:

Attributes of the <tab> node

Name of the first <xsd:element> placed in the tab.


If only one element (typically a nested content with sub-elements) should appear in one tab, the element's name can be hidden. Therefore, set collapse="true". Otherwise, omit it, or set it to false.


Define the name shown in the tab. If the attribute is not given, the element's name is used as the tab name. To localize the tab name, use the key label.{schema type name}.{tab name}. You can also add a tool tip via label.{schema type name}.{tab name}.help. See here for more information on localization.

When configuring tabs explicitly, the first tab should always start with the first schema element of your content. Otherwise OpenCms will add an additional first tab automatically.

You can improve this page

Please contribute your suggestions or comments regarding this topic on our wiki. For support questions, please use the OpenCms mailing list or go for professional support.