Variables

Variables are reusable values stored in Studio's Brand Kit that you define once and apply across your email layouts. Instead of manually updating each layout when an offer, link, or image changes, you update the Variable, and every layout that uses it will reflect the change automatically.

Use Variables to centralize content, schedule time-sensitive promotions, and keep your layouts consistent at scale.

Where to find Variables
Create a new Variable (step-by-step)
Schedule value changes (Text only)
Use Variables in layouts
Manage Promo Banners via Variables
See where a Variable is used (before changing or deleting)
Delete a Variable

Where to find Variables

Open Studio and go to Content → Variables. This page is your hub for creating, editing, scheduling, and managing variables tied to your brand’s emails and content.

Types of Variables

• Text: Dynamic values (e.g., offer copy, deadlines). Supports scheduling. 
  
• Link: Static values (e.g., URLs or logic-driven expressions). Does not support scheduling. Republish affected layouts to apply changes in live emails.
  
• Promo Banner variables: Pre-built variables for Top, Below Hero, and Below Product Grid banners. The variable behaves like Text (dynamic), and supports scheduling and mobile overrides where applicable.
  

Naming rules and constraints

• Names must start with a dollar sign (e.g., $PrimaryOffer) and are case-sensitive.
  
• Use unique names per website ID to avoid conflicts and errors.
  
• Hyphens are not allowed in Variable names (use underscores instead).
  

Create a new Variable (step-by-step)

1) Go to Content → Variables and click Add a new text variable.

2) Enter a unique Name (e.g., $HolidayOffer), select a Type (Text or Link), then set the Value.

3) Optional (Text only): Add a schedule (start/end time) for time-bound swaps (e.g., pre-sale → general sale). Click OK, then Save at the top right.

Example (Text):

• Name: $PrimaryOffer
• Value: 25% off sitewide
• Schedule: 11/24 9:00 AM → 11/28 9:00 PM (local timezone)
  

Example (Link with nested logic):

• Name: $ReturnPolicyUrl
• Value:  https://brand.com/returns
• Note: Use Link type if you plan to reference other Variables later.
  

Edit an existing Variable

1) On Content → Variables, click the three dots (…) next to a variable and select Edit.

2) Update the Value, click OK, then Save. Text Variables update immediately across layout previews and live emails.

3) For Link variables, publish the updated layouts for changes to appear in emails.

Schedule value changes (Text only)

1) Next to a Text Variable, click (…) → Edit → toggle on Scheduled Value Overrides.

2) Add the scheduled value and timeframe (your browser’s local timezone is used). Click OK → Save.

3) For multi-stage campaigns, set up sequential, stacked schedules (e.g., Early Access → Friends & Family → General Offer). Avoid overlapping windows.

Example stacked plan:

• 11/24 12:00 AM–11/24 11:59 PM → “Early access: 30% off”
• 11/25 12:00 AM–11/27 11:59 PM → “Friends & Family: 25% off”
• 11/28 12:00 AM–12/01 11:59 PM → “Cyber Event: 30% off + Free Shipping”
  

Use Variables in layouts

• In any layout, click into a Text or Link input and type the Variable name (e.g., $PrimaryOffer) to see the rendered value in preview.
  
• Variables also work in Subject Line and Preview Text; as you type, Studio surfaces helpful suggestions for Text Variables.
  
• Advanced usage in Custom HTML blocks:

  • Brand Kit syntax:

    $$smartField.$MySmartField

  • Golang syntax (advanced):
    {{ $.Studio_MySmartField | noescape }}

Manage Promo Banners via Variables

There are pre-built pairs that control the three global banner placements:

• “BannerImg” Variables store the image URL.
• “BannerUrl” Variables store the clickthrough URL.
  

To activate or change a banner:

• Edit the matching “BannerImg” to paste an image URL, then OK → Save.
  
• Edit the matching “BannerUrl” with your destination link, then OK → Save.
  

Notes:

• Banner content should be managed via these dedicated Variables; if you previously set values at the block level, the Variable values govern the final output.
  
• To temporarily hide a banner, clear the “BannerImg” value; to swap in another banner for a defined period, use a scheduled value.
  

Example banners:

• $TopBannerImg →  https://cdn.brand.com/promo/top_banner_black_friday.png

• $TopBannerUrl →  https://brand.com/black-friday

See where a Variable is used (before changing or deleting)

• On the Variables page, click (…) → View usage to see where a variable appears across blocks and layouts. This helps you assess impact before edits or deletion.
  

  

Delete a Variable

• You can only delete a Variable if it’s not being used by any blocks or active layouts. Use the usage modal first to confirm it’s safe.
  

• Deletion is available to users and helps keep your list tidy. Coordinate with your team to ensure nothing relies on the variable before removing it.
  

  

Best practices

• Use Text type for short, frequently updated copy (e.g., “25% off sitewide”) and for scheduled promotions that must update instantly across layouts.
  
• Use Link (or Advanced) for URLs and logic-driven values; remember there’s no scheduling, and updates apply when layouts are republished for delivery.
  
• Keep naming clear and consistent (e.g., $PrimaryOffer, $PrimaryCTAUrl, $ReturnPolicyUrl). Avoid hyphens; use underscores if needed. Names must be unique and begin with a $ symbol to work properly.
  
• Plan sequential, stacked schedules for multi-stage initiatives (no overlaps) so content transitions automatically at each campaign phase.
  

With Variables, you can centralize content values, plan timed updates with schedules, and keep layouts in sync, so your team moves faster and stays consistent across every message.
 

Feedback & Support

To share feedback or request enhancements:

• Submit a ticket via the Wunderkind Help Center
• Contact your Customer Success Manager for feature discussions or roadmap visibility

For technical assistance, submit a ticket via the Wunderkind Help Center or reach out to support@wunderkind.co.