Source: https://mindstamp.com/help/how-do-i-use-personalization-and-dynamic-variables-on-mindstamp
Generated from the Help Center records: 2026-10-05

# How do I personalize a video with variables?

Topic: [Interactions and logic](https://mindstamp.com/help/interactions) · Updated: 2026-09-25

## Short answer

A variable is a named value, such as a viewer’s name or an answer, that Mindstamp keeps while the video plays. Type it in double braces, such as {{name}}, in text, button labels, questions, or click values, and the player replaces it with the viewer’s value. Personalization variables are on Core and higher plans.

## Steps

1. Choose the value you need and where it comes from: a question, a click, lead capture, the link, or a navigation.
2. Set the variable. On a question, choose a **Variable** in the **Variables** section. On a button, hotspot, image, or text, open **Variables & Logic** and enter a **Variable** and a **Value**.
3. Type the variable in double braces where the value should appear, for example “Welcome back, {{name}}.”
4. Write the sentence so that it still reads well if the value is empty.
5. Test in **Preview**. To test a link value, add it to the share link, for example ?name=Test.

![Variables & Logic section of a Mindstamp button with the Variable set to interest and the Value set to pricing](https://cdn.mindstamp.com/website2026/help/button-set-variable.webp)

_In Variables & Logic, choose the variable a click sets and the value it stores._

![New personalized link page in Mindstamp with the viewer Name and Email fields, the variables for this link and the View all links button highlighted](https://cdn.mindstamp.com/website2026/help/personalized-link.webp)

_Personalize for a recipient: enter who the link is for and the variable values it sets. Views of the link report under this viewer._

## Where variables come from

- A question: the answer is stored in the variable you choose.
- A click: a button, hotspot, image, or text sets a variable to a fixed value.
- [Lead capture](https://mindstamp.com/help/how-do-i-capture-name-email-or-phone-number-in-my-mindstamp-video): sets name, email, phone, custom_id, and your custom fields.
- The link: any parameter on the share link or embed URL becomes a variable.
- A navigation: **Set Variable**, under **More** > **Logic & AI** in the add bar, sets a value at a time you choose.

## Pass values in the link

Add parameters after a question mark and join them with &, for example https://share.mindstamp.com/w/abc123?name=Brett&custom_id=12345&fruit=banana.

The name, email, phone, and custom_id parameters also identify the viewer, so the view is reported under that person. Any other parameter, such as fruit, becomes a variable you can show with {{fruit}}.

After the player reads the parameters, it removes them from the address bar. This does not mean they failed.

## Pass values into an embedded video

Add the same parameters to the src of the embed iframe. If your page knows who the viewer is, a short script can add the values when the page loads. Put it after the embed code and replace the example values with your own data.

```
const viewer = { name: 'Brett', email: 'brett@example.com', custom_id: '12345' }
const values = Object.entries(viewer).filter(([, value]) => value)

document.querySelectorAll('iframe[src*="mindstamp"]').forEach((frame) => {
  const url = new URL(frame.src)
  for (const [key, value] of values) url.searchParams.set(key, value)
  frame.src = url.toString()
})
```

## Rules for placeholders

- Use two braces on each side: {{name}}. Spaces inside the braces are fine.
- Use only letters, numbers, and underscores in the name. {{first_name}} works; {{first-name}} does not.
- Capital letters do not matter. {{NAME}} and {{name}} show the same value.
- If a variable has no value yet, the placeholder shows nothing.

## Numbers and scores

Under **Value**, **Increment +1** and **Decrement -1** write an expression such as {{ score + 1 }} that adds to or subtracts from a number each time it runs. The player also sets cScore, the percent of scored questions answered correctly, and pScore, the percent of scored questions answered.

## Use variables beyond text

- Show or hide interactions with [conditional logic](https://mindstamp.com/help/how-can-i-create-a-video-with-conditional-logic) (Pro and higher).
- Put a variable in a link, such as https://example.com/offer?role={{role}}.
- Turn on **Append variables when opening links** in the video’s **Settings** to add every variable to links that the video opens.
- Send one personalized link to each person from **Share** > **Personalize for a recipient…**. See [How do I personalize video links from my CRM or website?](https://mindstamp.com/help/personalize-video-links-from-crm).

## Keep personal data out of links

Anyone who sees a link can read its parameters. Do not put private data in a link. A personalized link keeps the values in Mindstamp and shows only a link ID.

## Go further

- [Variables tutorial](https://mindstamp.com/tutorials/variables)
- [Personalization](https://mindstamp.com/features/personalization)

## Related answers

- [Why aren’t my personalization variables being replaced?](https://mindstamp.com/help/personalization-variables-arent-replacing-in-my-video-why)
- [How do I personalize video links from my CRM or website?](https://mindstamp.com/help/personalize-video-links-from-crm)
- [How do I pass URL parameters from my page into an embedded video?](https://mindstamp.com/help/pass-url-parameters-into-an-embed)
- [Do variables carry over when a viewer switches videos?](https://mindstamp.com/help/do-variables-persist-across-branches)

---

Need more help? [Contact Mindstamp](https://mindstamp.com/contact) · [Help Center](https://mindstamp.com/help) · [All Help Center articles as JSON](https://mindstamp.com/help-feed/index.json)