# 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: 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: ``` GET https://docs.arcade.software/kb/build/interactive-demo/edit/variables.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.