> 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**

Take your AI agents even further with custom variables that let you 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 space, you must be a supervisor member with Admin 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 with 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 **Settings → 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 type of variable (Text or Link)
* **Value** : the Edit values button lets you quickly access editing the value of your variable for each of your locations and brands.

From this table, you can:

* search for a variable using the search bar
* create a new variable
* edit an existing variable
* delete a variable
* edit the values of your variable for your brands and locations

Actions **Edit**, **Edit values** and **Delete** are accessible via the three-dot menu **⋯** to the right of each variable.

***

## Create a custom variable

To create a variable, click on **Create a variable** and configure the fields of your variable

{% 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's instructions using `{{}}`, for example `{{booking_link}}`.
{% endstep %}
{% endstepper %}

***

## Edit a variable

To edit an existing variable:

1. Go to **Settings → Variables**
2. Click on 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 modify 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 on 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 by brand and location

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

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

Once a custom variable has been created, you can **set its value for each brand or location** so that it can be used correctly by your AI agents, allowing responses generated to be dynamically adapted according to the brand or establishment involved in the customer interaction.

To do this, from the custom variables table, or from the edit menu of a custom variable, click on the button **Edit values**.

The **Locations** displays all your locations: you can then easily set or edit the value of your variable for each of your locations.

The **Brands** displays all your brands: you can then easily set or edit the value of your variable for each of your brands.

You can also change the value of your variables at any time from the settings of your [Locations](/documentation/documentation-en/get-started/locations.md#onglet-variables) and your [Brands](/documentation/documentation-en/get-started/brands.md#onglet-variables).


---

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