Project variables

Project variables let you share settings across all definitions in your project from a single place. When you update a variable, the change applies automatically everywhere it's used. Common uses include company address, year, or logo URL.

Project variable benefits

Project variables can help you:

• Share common settings across scenarios in multiple projects.
• Reduce manual work when you copy scenarios across projects.
• Speed up project-wide changes in scenarios.

How project variables work

To access account-level project variables, go to Project settings > Account > General > Project variables.

To access project-specific variables, go to Project > General.

👍

Unified login

For a unified login setup, see Unified project variables.

Create a project variable

To create a new variable, click Create new project variable.

🚧

Important

The Account Admin role is required to create project variables. The Project Admin role is sufficient to adjust existing ones.

After clicking the button, the following fields appear:

• Name: The name by which you recognize this variable.
• Jinja reference name: The variable name used in Jinja code. Only alphanumeric characters are allowed.
• Description: The description shown when selecting a variable.
• Account default value: The value shown in all projects in the account unless a project-level value is defined.

To set different values for specific projects, go to Project configuration > + Add project. This is useful when values differ across company branches, for example different addresses for different locations.

Edit project variables

You can edit project variables at both the account and project levels. Click Edit to open the edit modal.

• At the account level, you can edit values for all projects.
• At the project level, you can edit values for specific projects only.

🚧

Important

• You can reset a project value to its default from the project level only. At the account level, you can only change values to different values.
• You can delete project variables at the account level. New variables cannot share the same name or Jinja reference name as an existing or previously deleted variable.

Use project variables

You can reference project variables in Jinja using the Jinja reference name. Insert {{project_variables.JINJA reference name}} anywhere in Bloomreach that accepts a Jinja input. For example: {{project_variables.Company_Address}}.

Project variables are also accessible as Personalization tags in the email editor.

Alternatively, you can insert them using the personalization tab.

Limitations

• A maximum of 100 project variables per account.
• A maximum of 1,000 characters per value.
• The Jinja slug allows only alphanumeric characters and _ (underscore).
• The Jinja slug must start with a letter.
• Two variables cannot share the same name or Jinja slug.
• If you delete a project variable, a new one cannot use the same name.