OpenCms documentation
OpenCms documentation

Properties dialog

Properties are key-value pairs that are attached as metadata to resources in OpenCms. There are several predefined properties used at various places, e.g., the Title or the NavPos property. Properties can be exposed or hidden from content editors and you are also allowed to define your own properties.

Here we explain how to edit properties.

The properties dialog can be opened from various places:

  • The page editor: Press "Properties" in the Context menu exposed via the editor toolbar to edit the properties of the current container page.
  • The sitemap editor: Press "Properties" in the context menu of the sitemap or the single pages. Be aware that you edit the properties of folder and container page in the default sitemap editor view.
  • The explorer app: Right-click on a resource and choose "Properties" to edit the properties for a resource.

The "Edit properties" dialog allows you to edit properties of a resource. Depending on your permissions and the actual resource it may differ slightly. The dialog has the following tabs:

  • The "Basic properties" tab is shown for all users that have access to the dialog. It is in particular intended for properties that should be changeable easily by content editors. Which properties are shown and how (friendly name, widget used, ...) can be configured as explained here.
  • The "Complete properties" tab shows all properties of a folder. Template developers are allowed to add further properties.
  • The "Individual  properties" and the "Shared properties" tabs show all individiual/shared properties of a file and template developers get an option to add properties. More information about the difference between individual and shared properties is found here.
The 'Individual Properties' tab of the properties dialog

The edit properties dialog (see Figure [properties_dialog]) shows the values of properties

  • in black if they are set directly on the resource for which the properties are shown in the dialog
  • in italics and gray if the value is inherited.

For inherited values of properties you get information on where these values are set by hovering over the little "info"-icons.

Except for the "Basic Properties" tab, all properties shown are grouped into "Used Properties" and "Unused Properties". Open the "Unused Properties" group to set the value of a property that has not yet any directly set nor inherited value.

The dialog also allows you to add new propertiesThat means, properties that are not set on any other resource in the VFS. To do this, click the gear wheel in the lower left corner of the dialog.