Skip to content

Dot notation

Dot notation is a way to access data in internal state of workflow. It is a standard way to reference data in Tracardi. It is used across many places in Tracardi such as plugins, destinations, etc.

Example of dot notation

Dot notation is build from source and path to data. Available sources are:

  • profile
  • event
  • payload
  • flow
  • session
  • memory

Path is a string of keys that indicate where the data is placed.

For example if your profile data looks like this

   "key": {
        "data": "value"

To access "value" your path will need to look like this:

The full access dot notation is


If there is an error in dot notation or it is not in a right format e.g instead of then the result is the typed value, in this example That means that any value that is not a valid dot notation will be returned as is.

Path to part of data

There is also a way to access a part of data.

A path like profile@key will return:

  "data": "value"

To access all data from profile type:

profile@... #(1)
  1. Return the whole profile object

Path to array items

Items in array can be accessed like this. For the payload data:

  "data": ["value1", "value2"]

accessor that get value1 should look like this.



Also objects embeded inside arrays can be retrieved the same way.

Read also about:

Notations that use dot notation: