> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/documentation/documentation-en/automations/variables.md).

# Variables

{% hint style="success" %}
**IN BRIEF**

Deepen your AI agents even further with custom variables that allow you to dynamically personalize your AI agents based on context.
{% endhint %}

{% hint style="info" icon="lightbulb" %}
The **custom variables** allow you to dynamically insert information into the responses generated by your AI agents.\
They are especially useful when you manage **multiple brands or locations** and certain information needs to vary depending on the context (for example, a booking link, a menu, or a specific description).
{% endhint %}

{% hint style="info" icon="shield-check" %}
**ACCESS RIGHTS**

To edit the Variables in your Fullwhere workspace, you must be a supervising member with Administrator rights.
{% endhint %}

A variable is defined once in your workspace, then you can **set a different value for each location or brand**.

For example:

* a variable **activity description** can contain different text for each of your locations
* a variable **booking link** can point to a different URL for each of your establishments

When an AI agent generates a response, the variable used in its instructions is **automatically replaced by the value corresponding to the location involved in the customer interaction**.

***

To access the variable settings, go to **Settings → Variables.**

## The variables table

In the **Automation → Variables**, you will find the list of all custom variables present in your workspace.

For each variable, the table shows:

* **Name** : the readable name of the variable
* **Variable** : the placeholder to use in agents
* **Type** : the variable type (Text or Link)

From this table, you can:

* search for a variable using the search bar
* create a new variable
* edit an existing variable
* delete a variable

The actions **Edit** and **Delete** are accessible via the three dots **⋯** to the right of each variable.

***

## Create a custom variable

To create a variable, click **Create a variable** and configure your variable's fields

{% stepper %}
{% step %}

### Type

Determines the content type of the variable:

* **Text** : for text content (e.g. activity description)
* **Link** : to insert dynamic URLs (e.g. booking link)
  {% endstep %}

{% step %}

### Name

Readable name of the variable in the interface.\
Example: `Booking link`
{% endstep %}

{% step %}

### Variable (placeholder)

Identifier used in agents to call the variable.

Best practices:

* use only **lowercase letters**
* use **hyphens or underscores**
* **no accents or spaces**

Example: `booking_link`.

To use a custom variable in an AI agent, you must insert it into your agent instructions using `{{}}`, for example `{{booking_link}}`.
{% endstep %}
{% endstepper %}

***

## Edit a variable

To edit an existing variable:

1. Go to **Automation → Variables**
2. Click the menu **⋯** to the right of the variable
3. Select **Edit**

You can edit:

* **the variable name**
* **the placeholder (variable)**

Once created, a variable's type cannot be changed.

{% hint style="danger" %}
If you change the **placeholder** of a variable, you will also need to **update all occurrences of this variable in your agents**.\
Otherwise, the old references will no longer work.
{% endhint %}

***

## Delete a variable

To delete a variable:

1. Go to **Automation → Variables**
2. Click the menu **⋯** to the right of the variable
3. Select **Delete**
4. Confirm deletion

{% hint style="danger" %}
Deleting a variable results in:\
\- permanent deletion of the variable\
\- deletion of all associated values in your brands and locations

If the variable was used in AI agents, it will no longer be recognized in the instructions.

**This action is irreversible.**
{% endhint %}

## Set the value of a variable for a brand or a location

Once a custom variable is created, you can **set its value for each brand or location** so that it can be used correctly by your AI agents.

{% hint style="info" icon="shield-check" %}
**ACCESS RIGHTS**

To edit the value of a variable for a brand or a location, you must have editing rights on this resource.
{% endhint %}

These values make it possible to dynamically adapt the generated responses according to the brand or establishment involved in the customer interaction.

Go to Settings > [Brands](https://app.fullwhere.com/settings/brands) or [Locations](https://app.fullwhere.com/settings/stores) and select the entity to edit, then in the navigation bar at the top of the page, click the tab **Variables**

You access the list of **custom variables available in your Fullwhere workspace**.

The table shows:

* **Name** : the name of the variable
* **Value** : the value currently set for the brand or location

If **no value is defined**, a **dash (-)** appears in the value column.

#### Set or edit a value

To set or edit the value of a variable:

1. Click the ✏️ icon on the right of the row
2. Enter the desired value
3. Click **Save**

The set value will then be used by your **AI agents** when the variable is called in their instructions: when generating a response, the variable used in the agent will be **automatically replaced by the value corresponding to the relevant brand or location**.


---

# 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.fullwhere.com/documentation/documentation-en/automations/variables.md?ask=<question>&goal=<endgoal>
```

`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.