Variable Scopes Variable Scopes

Variable Scopes

Nathan Price Nathan Price


In the studio and throughout your app, there are various different namespaces or scopes. This is a way of qualifying access to particular variables throughout your experience. The general best practice is to restrict your variable to least level of access you need in order to make your experience work. We will talk more about that below.

Some namespaces are editable and others are set at the beginning of the experience and cannot be modified.

High Level Scopes

On each journey there are some high level scopes:

  • Session - Contains start parameters and session level variables.

  • Profile - contains profile level configuration variables.

  • Theme - contains theme level configuration.

  • Activities - contains a list of all loaded activities.

  • ActivityGroups - contains a list of all loaded activity groups.

  • Configuration - Contains app specific configuration values.

Many of these high level scopes are used for app configuration and not really meant to be modified within your experience. The one main exception is Session where we can store variables that are able to accessed on any card, card view, bot, or event.

Note: While both Configuration and Profile scopes are modified in the configuration builder. The Configuration scope contains information about resources while Profile contains variables at the profile level.

Defining Session Level Variables

In the context of our apps, the term session and journey are interchangeable. Session or Journey level variables are set in the Journey builder. If you don’t see the Journey section on the right click anywhere on the stage.


Under variables you can click the plus and add session level variables. These variables will be available most places throughout the app, but remember they are not accessible within connection builder (you would need to pass them into a connection).

Working With Scopes Within Your Card Views

When working within your Cards and Card Views, you might want to create variables to store values throughout your application. In general the flow of the variable scoping looks like this:

  • Session (Journey) - accessible Everywhere.

    • Activity Group (Web Flow)- accessible to all web flows within the activity group.

      • Activity (Web Page) - accessible only on the on the current web page.


As mentioned above, the general best practice is to try to store you variables at the lowest scope. This will ensure the highest level of reusability of your web pages and web flows.

See types for information selecting the correct variable type.

To access a variable in a particular scope, for example in creating the text for a label, you put in the scope.variableName in the expression editor.


Working With Scopes Within Events

Events have their own scope as they do not exist within the context of a particular card. You can set variables on events by selected the Event Source in Journey Builder and adding variables. When you fire an event you can pass in values to the variable.


from within the event, you can then reference that value as and get the value passed in.

Working With Scopes Within Custom Controls

When building custom controls, you are able to define what inputs or data is available to the control. During the design of your custom control, any defined inputs will be available on the control context. For example, if your custom control has an input named title , then control.title is how you’d reference that variable within the control.

As you implement your custom control, you can pull variables from the sessionactivityGroup, or activity contexts.

Working With Scopes Within Connections

Connections exist as independent steps. They have access to all the inputs passed in but do not have access to things like session, even if they are run from a session. Also, future data operations have access to all the outputs created by previous data operations. This means that if you create a transform in the first step. You can still access the return value of that transform in the 5th step without having to do anything special.

Profile Variables

Your app can contain different profiles. Each profile has a unique set of values and resources associated with them. Talking about profiles in general is a whole different topic, but let's talk about how to create a profile level variable and modify it.

Go to Journey Builder and start like you would be creating a session level variable.


Once you have the variable created, right click on it. Select Convert To Setting from the dropdown.


The little symbol next to the variable name indicates that it is a profile level variable. Once you’ve set it to a profile variable, we can adjust the value of the profile variable in Configuration Builder. Scroll down the bottom until you see App Settings, you can insert a value in the value section.


You can change the value of configVar for each different app profile. You can then use this variable throughout your cards as profile.configVar. Profile variables have the same access restrictions as session level variables.

Was this article helpful?

1 out of 1 found this helpful