Default values

Attribute definitions on objects and lists support default values which are used to pre-populate values on records and entries.

There are two kinds of default value: static and dynamic.

Static defaults

Static values are raw values that are used directly without transformation. For example, you might want to always fill the “Deal Status” property on new entries in your “Sales” list to the value “Lead”.

Static values are supported on all attribute types. The template property on default values must match the type of the attribute. These types are documented in our endpoint reference docs.

Dynamic defaults

Dynamic values are used to generate values on the fly, depending on context. For example, you might want to fill in an “Owner” property to the current user, or set a due date to one week in the future.

Dynamic values take the form of a string. The currently supported list of dynamic value templates, broken down by attribute type, is as follows:

  • actor-reference attributes, with the default value current-user
  • timestamp or date attributes, with an ISO 8601 Duration e.g. “P1M” for one month in the future

Other attribute types do not currently support dynamic default values.