--- title: "Create demo variables" slug: "/help/demos/personalize/variables/create-variables" last_updated: "2026-04-15T10:41:52Z" zendesk_id: 32068744972563 zendesk_url: "https://help.walnut.io/hc/en-us/articles/32068744972563-Create-Variables" locale: "en-us" category: "Getting Started" section: "Editing & Customization Basics" product: "demos" topic: "personalize/variables" displayed_sidebar: "demosSidebar" sidebar_position: 7 --- ## **Overview** Walnut variables help you build once and personalize at scale. Instead of duplicating templates or manually updating the same content over and over, you can convert specific text, images, avatars, or dates into reusable variables. This gives you a much more flexible way to tailor demos for different viewers, workflows, and use cases while keeping your template structure consistent. Variables are one of the easiest ways to scale personalization in Walnut. They help teams reduce repetitive editing, keep templates cleaner, and adapt demos more quickly for outbound, follow-up, and customer-facing workflows. --- ## **Variable Types** Walnut supports four main variable types, each designed for a different type of personalization. :::tip[Text] Replaces part or all of a text element, including text inside guides. - **Date:** Replaces a static date with a dynamic one based on a selected format and offset. - **Image:** Replaces one image with another across the template. - **Avatar:** Replaces guide avatars, either globally or on selected guides. Avatar updates do not use the standard Variables menu, but they serve a similar personalization purpose. ::: :::note[Looking for advanced personalization workflows?] If you want to map variables to Salesforce, URL parameters, or lead forms, see [**Smart Demo Personalization with URL, CRM, and Lead Form Variables**](https://help.walnut.io/hc/en-us/articles/28697364380435) for a full setup guide and source-specific examples. ::: --- ## **Add Text Variables** Text variables are the most flexible variable type in Walnut. You can use them to personalize on-screen content, guide text, product names, company names, contact names, and more. There are a few different ways to work with text variables depending on your workflow: - Create a brand-new text variable first, then apply it later - Replace text with an existing variable - Use Find & Replace to apply variables across multiple instances at once - Create a variable while replacing text in the same workflow --- ### **Create a Standalone Text Variable** This workflow is useful when you want to create the variable first and decide where to apply it afterward.
To create a standalone text variable:
  1. Click any text element, or right-click a text element, to open the editing toolbar.

  2. Click the Variables icon to open the variables options.

    Screenshot showing the Variables icon in the Walnut editor toolbar.

  3. Click New Text Variable.

    Screenshot showing the New Text Variable option in Walnut.

  4. Complete all required fields:
    • Name: The label used for the variable
    • Description: Helpful context for your team
    • Get personalized value from: None, Salesforce, URL, or lead form
    • Default value: The fallback text shown if no personalized value is supplied
  5. Click Done.

  6. Open the Variables pane again to review where the variable is being used.

    Screenshot showing the Variables pane in Walnut.

If you created the variable from a text element you did not actually want to change, you can restore that text afterward. The variable itself will still exist and can be applied elsewhere.

Screenshot showing a variable listed as not yet in use in Walnut.

:::tip[Best practice] Use clear, human-readable variable names like **Company Name**, **First Name**, or **Product Name**. Clean naming makes personalization much easier to manage later. ::: --- ### **Replace Text with an Existing Variable** If the variable already exists, you can quickly replace a text element with it.
To replace text with an existing variable:
  1. Click the text element you want to replace.
  2. Click the Variables icon.
  3. Select the existing variable from the list.
  4. The selected text is replaced with the variable.
--- ## **Use Find & Replace with Variables** Walnut’s **Find & Replace** tool helps you replace repeated text across a template much faster. This is especially useful when the same product name, company name, or repeated phrase appears in multiple places and you want to convert all instances into a variable at once. :::note[Before you start] - Find & Replace scans all matching text in the template, including text behind overlays. - Existing variables appear in the replacement dropdown when relevant. - Review matches carefully before replacing all instances. ::: --- ### **Replace Text with an Existing Variable Using Find & Replace**
To replace a text string with an existing variable using Find & Replace:
  1. Open the template in edit mode.
  2. Click the parent element or screen where you want to search.

  3. Click the Search icon from the editor subheader to open the Find & Replace pane.

    Screenshot showing the Find and Replace pane in the Walnut editor.

  4. Enter the text you want to replace.

  5. In the Replace with field, select the existing variable.

    Screenshot showing an existing variable selected in Find and Replace.

  6. Review the results.
  7. Click Replace All.

  8. Confirm the action.

    Screenshot showing the Replace All confirmation message in Walnut.

Once confirmed, all matching text is replaced with the selected variable.

--- ### **Replace Text and Create the Variable at the Same Time** If you have repeated text in the template but have not created the variable yet, you can do both in one workflow.
To replace text and create the variable at the same time:
  1. Repeat steps 1 through 4 from the previous Find & Replace workflow.

  2. In the Replace with field, select New Text Variable.

    Screenshot showing the New Text Variable option in the Find and Replace replacement menu.

  3. Complete the variable setup window.

    Screenshot showing the text variable setup window in Walnut.

  4. Add the variable name, description, source, and default value.
  5. Click Done.
  6. Click Replace All.

Walnut creates the variable and applies it to all matching text in one step.

--- ### **Replace Text Using a Personalized CRM Variable** This workflow is similar to creating a new text variable, but you must choose the CRM source during setup. Depending on your connected source, available mapped values may include company name, full name, first name, or last name. --- ## **Add Image Variables** Image variables let you swap one image for another while keeping the rest of the template structure unchanged. This is especially helpful when personalizing logos, product visuals, screenshots, or branded graphics across different demos.
To replace an image with an image variable:

  1. Right-click the image and select Variables > New image variable, or click the Variables icon from the edit toolbar.

    Screenshot showing how to create a new image variable in Walnut.

  2. Complete the variable details.
  3. Click Done.

Note: The selected image becomes the default value for the variable, but you can update it later by uploading a different image.

--- ## **Add Dynamic Date Variables** Dynamic Date is a built-in variable that keeps date-based content current inside your demo. It is useful when you want to show: - today’s date - tomorrow’s date - yesterday’s date - a date offset by days, weeks, or months You can also control the date format, which makes Dynamic Date especially useful when building demos for different regions or formatting needs. --- ### **Add a Dynamic Date Variable**
To add a dynamic date variable:

  1. Open the template in edit mode and locate the text where you want the dynamic date to appear.

    Screenshot showing a text area where a dynamic date will be inserted in Walnut.

  2. Click Edit Content and place your cursor where the date should appear.

  3. Click the Variables icon and select Dynamic Date.

    Screenshot showing the Dynamic Date option in the Variables menu.

  4. Choose the date format and set the offset if needed.

    Screenshot showing dynamic date formatting and offset options in Walnut.

  5. Click Done.

  6. In edit mode, a variable tag appears where the dynamic date has been added.

    Screenshot showing a dynamic date variable tag in the Walnut editor.

:::note[Example] To display yesterday’s date, set the date offset to **\-1 day**. ::: --- ### **Remove a Dynamic Date Variable**
To remove a dynamic date variable:

  1. Select the dynamic date, click the Variables icon, and choose Remove Dynamic Date.

    Screenshot showing the Remove Dynamic Date option in Walnut.

  2. Alternatively, click the three-dot menu and select Variables > Remove Dynamic Date.

    Screenshot showing the Remove Dynamic Date option from the three-dot menu in Walnut.

--- ## **Add Avatar Variables** Avatars help personalize your guides and give them a more human, branded, or role-specific presence. You can apply the same avatar across every guide in a template, or choose different avatars for selected guides. :::tip[Note] Avatar updates do not open the standard Variables menu, but they function in a similar way by letting you swap guide-level visual identity without rebuilding the guide itself. ::: --- ### **Add the Same Avatar to All Guides**
To add the same avatar to all guides:
  1. Open the template in edit mode.

  2. From the right-hand toolbar, click the Guides icon to open the Guides pane, then click the gear icon.

    Screenshot showing the Guides pane settings access in Walnut.

  3. Select Avatar and upload the new image.

    Screenshot showing avatar upload options for all guides in Walnut.

  4. The new avatar is applied across all guides in the template.
--- ### **Add or Change an Avatar on Selected Guides**
To add or change an avatar on selected guides:

  1. Open the template in edit mode, then click the Guides icon from the right-hand toolbar.

    Screenshot showing the Guides pane in Walnut.

  2. Select the guide you want to update.

  3. Click the guide pane highlight area to open the guide editing toolbar.

    Screenshot showing the selected guide and edit toolbar in Walnut.

  4. Click the Settings icon and upload a new avatar.

  5. The new avatar is applied only to the selected guide.

    Screenshot showing a guide with an updated avatar in Walnut.

Repeat this process for any other guides where you want a different avatar.

--- ## **Key Takeaways** :::note[Text variables] are the most flexible option for personalizing repeated content across templates and guides. - **Find & Replace** is the fastest way to convert repeated text into variables across a template. - **Image variables** help you personalize visual assets without rebuilding layouts. - **Dynamic Date** keeps time-sensitive content current automatically. - **Avatar updates** help tailor guide presentation globally or at the guide level. ::: :::note[Final Takeaway] Variables are one of the most practical ways to scale personalization in Walnut. They help you keep templates reusable, reduce manual edits, and create experiences that feel more relevant without multiplying your build work. :::