Skip to main content

Properties

A property is a field that describes assets of a given type. Each created property becomes available for all assets of that type.

Access

  1. Go to OrganizationMetamodel
  2. Click on an asset type
  3. Select the "Properties" tab

Property types

The current metamodel supports these property types. The names below match the labels used in the metamodel interface.

TypeAccessible nameTypical use
TextShort textNames, identifiers, versions
Long textLonger textNotes, functional descriptions
Rich textFormatted textDocumentation, guides
NumberNumeric valueUser count, capacity
PercentagePercent valueUsage rate, availability
CurrencyMonetary valueBudget, license cost
DateCalendar dateGo-live date, end of support
Booleanyes/noActive, critical, compliant
Listsingle-choice listStatus, criticality, environment
List multiplemulti-choice listTechnologies, platforms
ScoreRating scaleCriticality, maturity
Unique keyUnique identifierExternal ID, code, reference number

Unique key

The unique key type stores a value that must be unique across all assets of the same type. Use it when assets have a stable external identifier, such as a product code, an HR reference, or an application ID from another system.

The field appears locked by default. Unlock it to enter or change the value. Boldo enforces uniqueness: if another asset of the same type already uses that value, the save is rejected.

Unique key values cannot contain the following characters: : / ? # [ ] @ ! $ & ' ( ) * + , ; = \ or spaces.

Unique keys are especially useful for CSV import and API workflows. During import, you can match rows by unique key instead of by name or Boldo ID, which reduces duplicates when the same data is imported repeatedly. The API can also address assets by their unique key through composite keys.

Create a property

  1. Click "Create property"
  2. Configure:
    • Name: Displayed label
    • Type: Choose from types above
    • Description: Optional explanation
    • type-specific options such as Default value, Possible choices, Minimum, or Maximum
  3. Click "Create"
tip

The property is immediately available in forms for all assets of the type.

Modify a property

  1. Click the edit icon of the property
  2. Modify parameters
  3. Click "Validate"
Data loss

Changing the property type can invalidate existing values and must be treated as a destructive change.

Delete a property

  1. Click the edit icon of the property
  2. Click the delete icon
  3. Click "Confirm"
Irreversible

All values of this property are permanently deleted for all assets.

Property groups

A property group is a named section that organizes properties on an asset type. Groups appear as titled cards wherever properties are displayed: create and edit forms, the Information tab, the preview panel, and the floating detail card on diagrams. Ungrouped properties fall into a section at the bottom.

Use groups when a type carries enough properties that a flat list becomes hard to read.

Create a group

  1. On the asset type, select the "Properties" tab
  2. Click "Create property group"
  3. Enter a name and click "Create"

Drag any property card into the group to assign it. The drop position sets the display order within the group.

Rename, reorder, or delete a group

Click the pencil icon to rename a group inline. Drag the group handle to reorder. Use the trash icon to delete: properties inside are preserved and become ungrouped.

Permissions

Only administrators can create, rename, reorder, or delete property groups.

Built-in attributes vs custom properties

The metamodel distinguishes custom properties from built-in attributes.

AttributeDescription
NameBuilt-in identifier
IconBuilt-in icon attribute

Best practices

  • Choose the simplest type that fits the need
  • Use List or List multiple when users should pick from a controlled list
  • Keep names explicit
  • Avoid overloading one asset type with too many fields
  • Document properties with descriptions when the expected meaning is not obvious