FieldPropertyType Type Alias
FieldPropertyType = "quantity" | "coordinate" | "string" | "boolean" | "datetime" | "int-enum" | "string-enum"
Enumerates the different kinds of Property values that can be used as the basis for a FieldRun's display string. A field's property type is derived from the property's PrimitiveType and other attributes like its PrimitiveOrEnumPropertyBase.extendedTypeName. The conversion of the raw property value into a display string can be customized by different FieldFormatOptions based on its type. The following types are currently recognized:
- "quantity": an often-unitized scalar value like a distance or area, formatted using a quantity Format.
- "coordinate": a 2- or 3-dimensional point, with each component formatted as a "quantity".
- "boolean": a true or false value; currently converted via
toString()(localized formatting not yet implemented). - "datetime": an ECMAScript Date.
- "int-enum": an integer EnumerationProperty; currently converted via
toString()(display-label lookup not yet implemented). - "string-enum": a string EnumerationProperty; currently converted via
toString()(display-label lookup not yet implemented). - "string": a value convertible to a string.
@note "quantity" and "coordinate" values format through the quantity pipeline when a
Format resolves for the field, from the FormatSets configured via
ElementDrivesTextAnnotation.registerFieldFormatting or from the iModel's schemas.
Otherwise they render as value.toString() — a bare number, or (x, y[, z]) for a coordinate.
Defined in
Last Updated: 02 October, 2026