Field

A field’s metadata.

Where possible, we changed noninclusive terms to align with our company value of Equality. Because changing the often-used term master-detail can break customer implementations, we maintained this reference.

Important

Property NameTypeDescriptionFilter Group and VersionAvailable Version
apiNameStringThe API name for this field.Small, 41.041.0
calculatedBooleanIndicates whether the field is a custom formula field.Small, 41.041.0
compoundBooleanIndicates whether the field is a top-level compound field.
If the dataType is Location, this value is usually false.
Small, 41.041.0
compoundComponentNameStringIf this field is a component field of a compound field, the value is the normalized component name, otherwise the value is null. For example, if the field represents "BillingStreet" of an Address compound field, this property contains "Street".Small, 41.041.0
compoundFieldNameStringIf this field is a component field of a compound field, this property contains the top-level compound field. Otherwise, the value of this property is null.Small, 41.041.0
controllerNameStringIf this field is a dependent picklist, this property is the name of the field that controls the values of the picklist.Small, 41.041.0
controllingFieldsString[]If this field is a dependent picklist, this property is a collection of fields that control the values in the picklist. When there’s a hierarchy of controlling fields, the collection starts with the immediate parent and moves up the tree.Small, 42.042.0
createableBooleanIndicates whether the field can be created.Small, 41.041.0
customBooleanIndicates whether the field is custom.Small, 41.041.0
dataTypeStringField type. One of these values:Small, 41.041.0
defaultValueStringDefault value for the field.Small, 66.066.0
defaultedOnCreateBooleanIndicates whether the field is automatically assigned a default value when a record is created.Small, 66.066.0
digitsIntegerFor integer fields, the maximum number of digits that an integer can have.Small, 65.065.0
externalIdStringExternal ID of the field.Small, 60.060.0
extraTypeInfoStringMore data type information. One of these values:
  • ExternalLookup—External lookup
  • ImageUrl—Image url
  • IndirectLookup—Indirect lookup
  • PersonName—Person name
  • PlainTextArea—Plain text area
  • RichTextArea—Rich text area
  • SwitchablePersonName—Switchable person name
Small, 41.041.0
filterableBooleanIndicates whether the field is filterable. If true, then this field can be specified in the WHERE clause of a SOQL statement.Small, 41.041.0
filteredLookupInfoFiltered Lookup InfoIf the field is a reference field type with a lookup filter, this value contains the lookup information.Small, 41.041.0
highScaleNumberBooleanIndicates whether the field stores numbers to 8 decimal places regardless of what’s specified in the field details.Small, 41.041.0
htmlFormattedBooleanIndicates whether the field is formatted for HTML and should be encoded for display in HTML. Also indicates whether a field is a custom formula field that has an IMAGE text function.Small, 41.041.0
inlineHelpTextStringThe text that appears in the field-level help hover text.Medium, 41.041.0
labelStringText label that appears next to the field in the Salesforce user interface. This label may be localized.Small, 41.041.0
lengthIntegerFor string fields, the maximum number of Unicode characters.Small, 41.041.0
maskTypeStringMask type of the field.Small, 60.060.0
nameFieldBooleanIndicates whether the field is a name field.Small, 41.041.0
polymorphicForeignKeyBooleanIndicates whether the field is a foreign key over a domain of multiple objects.Small, 41.041.0
precisionIntegerFor double fields, indicates the maximum number of digits that can be stored, on both sides of the decimal point.Small, 41.041.0
referenceBooleanIndicates whether the field is a foreign key to another record.
A reference field contains an ID value that points to a unique record (usually the parent record) on another object.
Small, 41.041.0
referenceTargetFieldStringFor indirect lookup relationships on external objects, this property is the target custom field of the referenced object.Medium, 41.041.0
referenceToInfosReference to Info[]For fields that refer to other objects, this list includes information about the object types and name fields of the referenced objects.Small, 41.041.0
relationshipNameStringThe name of the relationship, if this relationship is a master-detail relationship field.Small, 41.041.0
requiredBooleanIndicates whether the field is required when creating or editing a record.
To determine which fields are required in a layout, use the RecordLayoutItem.required property.
Small, 41.041.0
scaleIntegerFor double fields, indicates the number of digits to the right of the decimal point.Small, 41.041.0
searchPrefilterableBooleanIndicates whether a foreign key (relationship field) can be included in a SOSL WHERE clause.Big, 41.041.0
sortableBooleanIndicates whether the field is sortable. If true, then this field can be specified in a SOQL ORDER BY clause.Small, 41.041.0
uniqueBooleanIndicates whether a field’s value must be unique.Small, 41.041.0
updateableBooleanIndicates whether the field can be edited.Small, 41.041.0