Creating custom properties

Last updated: Sep 23, 2024

You can extend the default set of properties available for governance artifacts and catalog assets by creating custom properties.

You can create up to 1000 custom properties.

Required permissions

You must have the following user permissions:

Custom properties can contain the following metadata:

Name: Character limit of 255. A new custom property can’t have the same name as an existing property for the same asset or artifact type.; Names of custom properties can be translated into your browser language. The custom property owner must define the property as translatable by specifying the locale for the default language and supported languages in the localized property when creating an enumeration type definition.
Description (Optional): Character limit of 255.
Property type: Can't be changed after a custom property is created. Choose from:

Make searchable in global search: Enable this option to make custom properties searchable in global search and available for filtering. This setting also determines whether the values are visible when you are bulk-editing custom properties for multiple artifacts.; Modifying this setting after the custom property is created does not apply the change to any values that exist on the assets. To apply the change to a specific asset, you must edit any value of this custom property on this asset.
Allow multiple values: The user who adds values for the property can add multiple values for the same property.
Groups: Custom properties for predefined asset types need to be created inside a group. Ungrouped custom properties can be created only on custom asset types. Groups of properties can be assigned to multiple asset types.

To create a custom property:

Go to Administration > Configuration and settings > Asset and artifact definitions.
On the Artifacts page, select the artifact type for which you want to create a property.
In the overflow menu, select Open > New > Custom property.
Specify the name and optionally a description.
Select the property type.
If you selected the predefined values type, add your values.
Optionally, in the Advanced section, select the option to allow multiple values.
Click Create. The new custom property is available immediately.

To create a group:

Go to Administration > Configuration and settings > Asset and artifact definitions.
On the Asset page, select the asset type for which you want to create a property.
In the overflow menu, select Edit items > Add.
Choose New group to create a new group, or choose Add a group to select a group from the list.
The group is available immediately.

To create a custom property:

Click Add > New property or click New property next to the group in which you want to create a custom property.
Specify the name and optionally a description.
Optional. Click Show identifier to change the unique identifier. New unique identifier is generated automatically.
Select the property type.
If you selected the predefined values type, add your values.
Optionally, in the Advanced section, select the option to allow multiple values.
Click Create. The new custom property is available immediately.

To create a custom property:

Go to Administration > Configuration and settings > Asset and artifact definitions.
On the Asset page, select the asset type for which you want to create a property.
In the overflow menu, select Edit items.
Click New property next to the column for which you want to create a custom property.
Specify the name and optionally a description.
Optional. Click Show identifier to change the unique identifier. New unique identifier is generated automatically.
Select the property type.
If you selected the predefined values type, add your values.
Optionally, in the Advanced section, select the option to allow multiple values.
Click Create. The new custom property is available immediately.

Parent topic: Custom properties, relationships, and asset types