Naming Conventions¶
Consistent naming prevents production accidents and makes the Waulter dashboard immediately readable to any team member. Follow these conventions across configurations, scenarios, and GTM elements.
Configuration names¶
Pattern: [ENV] Site Name — Region/Details
| Example | Environment | Purpose |
|---|---|---|
[PROD] Acme Corp — EU | Production | Live EU configuration |
[DEV] Acme Corp — EU | Development | Testing copy |
[PROD] Acme Corp — US | Production | US-specific configuration |
[TEMPLATE] Standard EU Banner | Template | Master template (never active) |
[TEMPLATE v2] Standard EU Banner | Template | Updated version |
Rules¶
- Always start with the environment prefix in square brackets
- Use the company/site name as the primary identifier
- Add region, variant, or detail after a dash
- Keep it short enough to read in the dashboard list view
Scenario names¶
Pattern: [ENV] Description — trigger type
| Example | Purpose |
|---|---|
[PROD] EU visitors — all pages | Default production scenario |
[DEV] Staging subdomain | Routes staging traffic to DEV config |
[PROD] Campaign — Black Friday | Campaign-specific scenario |
[PROD] Premium users — customField1 | User-type targeting |
GTM variable names¶
Pattern: Waulter - [ENV] - Variable Name
| Example | Type | Purpose |
|---|---|---|
Waulter - PROD - Configuration ID | Constant | Production Configuration ID |
Waulter - DEV - Configuration ID | Constant | Development Configuration ID |
Waulter - Configuration ID | Lookup Table | Returns PROD or DEV ID based on hostname |
Waulter - Decision | Data Layer Variable | Reads decision from data layer |
Waulter - Purposes | Data Layer Variable | Reads purposes array from data layer |
Waulter - Web Analysis Allowed | Custom JavaScript | Checks if analytics purposes are accepted |
Waulter - Ads Allowed | Custom JavaScript | Checks if advertising purposes are accepted |
GTM tag names¶
Pattern: [Waulter] ENV — action
| Example | Purpose |
|---|---|
[Waulter] PROD — Consent Init | Production SDK tag |
[Waulter] DEV — Consent Init | Development SDK tag |
[Waulter] PROD — Cookie Policy | appendDocument tag for cookie policy page |
GTM trigger names¶
Pattern: Waulter - Trigger Description
| Example | Event | Purpose |
|---|---|---|
Waulter - Consent Decision | Waulter:Decision | Fires on any consent decision |
Waulter - Accept All | Waulter:Decision (with condition) | Fires only on "allow" decisions |
Waulter - Analytics Allowed | Waulter:Decision (with condition) | Fires when analytics purposes are accepted |
Waulter - Ads Allowed | Waulter:Decision (with condition) | Fires when advertising purposes are accepted |
Why naming matters¶
| Without conventions | With conventions |
|---|---|
Config 1, Test config, My site | [PROD] Acme — EU, [DEV] Acme — EU |
| Impossible to distinguish DEV from PROD at a glance | Immediately clear which is which |
| Risk of testing on production | Environment is obvious from the name |
| Hard for new team members to navigate | Self-documenting naming |
Establish conventions early
Set naming conventions before creating your first configuration. Renaming later is possible but disruptive. The earlier you standardise, the more consistent your dashboard will be.
Agency-specific conventions¶
For agencies managing multiple clients:
Pattern: [ENV] Client Name — domain.com
| Example | Purpose |
|---|---|
[PROD] Client ABC — abc.com | Client ABC's production config |
[DEV] Client ABC — abc.com | Client ABC's development config |
[PROD] Client XYZ — xyz.eu | Client XYZ's production config |
[TEMPLATE] Standard EU | Agency's master template |
This convention makes the dashboard scannable when managing 50+ client configurations.