> For the complete documentation index, see [llms.txt](https://docs.arcade.software/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.arcade.software/kb/build/interactive-demo/edit/variables.md). # Variables ### What are variables? Variables are placeholders you add to text elements inside your Arcade. When a viewer opens the Arcade, these placeholders are replaced with real values, like a person's first name or company name. For example:\ If you insert `{{ first_name }}` into your Arcade, it will display as "Hi, Alex!" if the viewer's first name is Alex. Variables turn your Arcades into flexible templates that adjust based on who’s viewing. {% embed url="" %} Personalization in action {% endembed %} *** ## Setting Up Variables ### Where can I define variables? You can define variables in the `Settings` modal of your Arcade editor. There, you can: * Add new variables * Edit existing ones * Set default values (optional) Arcade includes `first_name` and `company_name` by default to help you get started, but you can create as many as you'd like. Variables can contain letters, numbers, and underscores (e.g., `user_role`, `team_size`). {% embed url="" %} Configuring variables {% endembed %} ### Where can I use variables in my Arcade? Variables can be used in almost any text field, including: * Chapter titles and subtitles * Chapter buttons * Hotspots * Callouts * The Arcade title * The Arcade description To insert a variable, use double curly braces around its name (with or without spaces):\ Example: `{{ first_name }}` or `{{first_name}}` *** ## Personalization Use Cases ### How can I personalize Arcades in email campaigns? If you're using an email platform like SendGrid or Customer.io, you can merge their email variables into your Arcade’s link template. When the email sends, the variable values are inserted automatically. Example with SendGrid syntax: ``` https://app.arcade.software/share/ARCADE_ID?variable.first_name={{ first_name }}&variable.company_name={{ company }} ``` ### How can I use personalization in Intercom messages? Intercom allows dynamic variables in Messenger messages. You can use these to personalize Arcade links shown inside your product. For example, use Intercom's `{{first_name}}` variable in the Arcade URL to create a welcome message like: ``` https://app.arcade.software/share/ARCADE_ID?variable.first_name={{ first_name }}&variable.company_name={{ company }} ``` ### Can I personalize onboarding Arcades? Yes. Many teams embed Arcades directly inside their product to guide onboarding. You can use variables to customize Arcades based on user attributes — such as their role, company, or plan tier — making each experience more relevant. ### Can I personalize Arcades on my homepage? Definitely. You can combine tools like Clearbit Reveal with Arcade to personalize homepage Arcades. For example, you can show an Arcade that greets visitors by company name or suggests features based on their industry. ### What plan is Variables available on? Variables are accessible on our growth and enterprise plans only. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.arcade.software/kb/build/interactive-demo/edit/variables.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.