Variables at organisation level
Store reusable organisation-specific values like a support link or local phone number, instead of retyping them everywhere.
Keep reusable local values, like a support link or a local phone number, in one place so you never retype them across campaigns, templates, or integrations. This helps most when several organisations share the same campaign structure but need different local contact details, links, or routing values.
When to use Variables instead of General settings
Use the built-in General fields for standard organisation identity settings such as Enterprise Name, Notification Email, Address, social links, or CTA values.
Use Variables when you need extra organisation-specific values that do not already have their own dedicated field, for example:
- a support URL
- an external location code
- a local app link
- a brand-specific label reused in templates
What a variable looks like
Organisation variables are stored as a simple list of key-and-value pairs, for example:
| Key | Example value | Typical use |
|---|---|---|
location_code | paris-centre | Route data to the right external location |
support_url | https://example-brand.com/help | Reuse a local support or information link |
contact_phone | +33 1 80 00 00 00 | Reuse local contact details |
brand_label | Paris Centre | Insert a local label into templates |
The key is reused exactly as you write it, so stable naming matters.
Where organisation variables are used
Once a variable exists, the value can be reused in a few places without retyping it:
- Personalised emails — insert the value as a dynamic field. See Personalise emails with dynamic fields.
- Add-on configuration — organisation add-ons can use these values for organisation-specific routing.
- OmniLab Pages experiences — OmniLab Pages can reuse the variable set of the currently selected organisation.
For your technical team
If your team builds personalised emails or OmniLab Pages scripts, the exact way to reference these values is covered in the developer guides — see Writing organisation scripts and Liquid template bindings deep-dive.
Important limits
| Limit | What it means |
|---|---|
| Simple list only | The Variables screen stores one flat list of keys and values, not nested sections |
| No inheritance toggle | Variables are stored per organisation and are not automatically inherited from Global |
| Key changes are breaking changes | Renaming or deleting a key breaks any template, script, or add-on that expects that exact key |
Naming tips
- Prefer stable, descriptive keys such as
support_url,contact_phone, orlocation_code - Keep one meaning per key so teams know exactly what each value is for
- Rename or delete a key only after updating every template, script, or add-on that depends on it
Manage variables
Open the Variables tab
Switch to the target organisation, then open General Settings or Organization Settings and select Variables.
Add or edit key-value pairs
Create the key and set the value that should be reused in this organisation. Prefer stable, descriptive names so teams can reuse them consistently.
Save and test the consumer
After saving, test the place that reads the variable, such as an add-on field, a personalised email, or a OmniLab Pages experience.
Clean up only when the key is no longer referenced
Delete or rename a variable only after confirming that no active campaign, template, add-on, or script still depends on it.
Important when sharing templates
Variables do not move automatically between organisations
When a template is reused in another organisation, review the destination organisation's variable keys and add-on values. Template reuse does not guarantee that the target organisation already has the same local variable list.
Related
Templates: export, import, and reuse
Use the ZIP workflow when a template needs to move between environments or organisations.
Share a template across organisations
See the direct cross-organisation sharing workflow.
Organisations and scope in OmniLab
Review why templates and settings are scoped to the selected organisation.