What a variable is
A variable is one field in the property's analytics platform: a GA4 event parameter, a Universal Analytics custom dimension, an Adobe eVar or prop. The Variables list is the property's dictionary of them. Requirements point at these variables, and the list shows which requirements use each one.
Add a variable
- In Blueprint, click Variables in the sidebar.
- Click Add Variable.
- Pick the Name from the list of the platform's variables. Names already used on this property are greyed out. To add your own, pick the custom entry; a second Name box appears for a unique name. If you leave it empty, it is filled from the Title in lowercase with underscores.
- Enter a Title and a Description (both required).
- Fill in the optional fields below.
- Click Save.
| Field | What it does |
|---|---|
| Scope | Shown for GA4 (Event, User), Universal Analytics (Hit, Product, Session, User) and Firebase properties |
| Values | The allowed values, one tag per value |
| Examples | Sample values for testers |
| Tags | Labels for grouping; the property's existing tags are offered |
| Additional Testing Notes | Notes that carry into QA plans |
| Enabled | Off shows a warning icon on the list: the variable is not enabled in the platform |
| Required | Marks the variable as required |
| Global (ALL Requirements) | Applies the variable to every requirement on the property |
Some platform variables are indexed, such as a custom dimension. Picking one shows the matching index field, for example Custom Dimension Index or Product Index.
Find a variable
The Filters panel narrows the list by Search (name, title), Type, Enabled and Requirements. Click Reset to clear them. Click a column heading to sort.
The Requirements column lists each requirement that uses the variable. Its menu offers View Requirement and, where available, Edit Variable for that requirement's copy.
Clone, edit or delete
Each row has three icons. Clone creates a copy titled "- Copy" straight away and opens it; the copy is not linked to any requirement. Delete asks for confirmation, because the requirements that use the variable are affected.
Export to CSV
Click the download icon on the list header (Download as CSV). The file has Name, Title, Description, Enabled and Requirements for every variable on the property.