> ## Documentation Index
> Fetch the complete documentation index at: https://doc.qbilon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Variables

> Define reusable variables for automation and task configuration.

## Overview

The "Centralized Variables" feature allows you to manage specific values in one place. These values can then be reused by different tasks within the automation engine. This feature simplifies the maintenance of configuration data, especially for frequently changing data, such as passwords that are rotated regularly.

## General

An overview of all variable groups is available by navigating to the `Automations` section and selecting `Variables`. Only administrators have the rights to create, delete, and update variables and variable groups on this page.

### Variable Groups Overview

The variable groups table displays the following information:

* **Name**: The name of the variable group.
* **Created At**: The creation date of the group (e.g., "Jan 10, 2025, 15:30").
* **Used by Tasks**: A list of all the distinct tasks in which one or more of the group's variables are currently being used. Clicking on an entry in this column will direct the user to the corresponding automation.
* **Last Used**: The date the variables within the group were last accessed.

![Variables: Variable Groups Overview](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/ee965a77-1d2d-4a7f-950e-468a91abd280-screenshot-2026-04-22-155452.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=d0ab044918eaf3b3388017e53bcbeda7)

The `Variables` page showing a data table of variable groups. The table includes columns for `Name`, `Created At`, `Used By`, and `Last Used Actions`. A search bar is visible at the top, along with a `+New Variable Group` button.

The table supports searching for variable group names and descriptions. Additionally, the columns for `Name`, `Created At`, and `Last Used` are sortable.

## Managing Variable Groups

Clicking the `+ New Variable Group` button opens a dialog box that allows users to create a new variable group and define its variables.

### Variable Groups Configuration

* `Name`: Variable groups may have arbitrary names but must be globally unique.
* `Description`: Can contain an arbitrary value to describe the group's purpose.

### Variables Configuration

Within a group, multiple variables can be defined.

* `Name`: Must be unique within the specific variable group.
* `Value`: Must not be empty.
* `Secret`: If the "secret" option is checked, the value of the variable is visually masked. These values are encrypted at rest using secure encryption algorithms. To view the value, users can click the "Eye" icon to reveal it.

![Variables: Variables Configuration](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/3b3284d1-7cf7-495e-9f0e-a9a591240e3e-screenshot-2026-04-22-165210.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=89e6a5e2f5f5c6bc5fa570619be8564e)

Dialog for creating or editing a `Variable Group`: input fields for the group's `Name` and `Description` and below a list of variables with fields for the specific `Name` and `Value`, and a checkbox for `Secret`. A badge indicates if a variable is `Used by Tasks`.

### Deletion Rules

Specific deletion rules apply to prevent errors when running automations:

* Variable groups: Groups cannot be deleted if they contain any variables that are currently in use.
* Variables: Individual variables cannot be deleted as long as they are being used in at least one task.

## Using Variables in Automations

Users can utilize these centralized variables when configuring tasks in the automations section. This functionality is available exclusively for URL and text configuration parameters.

### Configuration Steps

1. Navigate to the `Automations` section and create or edit a task.
2. In the configuration dialog for URL or text parameters, the tab chooser allows you to switch between fixed (standard input) and variable.
3. Select `Variable` to display the selection fields.
4. Select `Variable Group`: Search for and select the desired group.
5. Select `Variable`: Once a group is chosen, select the specific variable from the dropdown menu.

![Variables: Configuration Steps](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/130f60fa-e28f-41ea-8103-b83371d494a6-screenshot-2026-04-22-165409.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=d6602d04740e31735a19a2facd691adf)

The task configuration screen has a URL/text input field. A toggle switch allows the user to choose between "Fixed" and "Variable." There are two dropdown menus: one for selecting the "Variable Group" and one for selecting the specific "Variable."

Note that input validation (e.g., checking if a value is a valid URL) is not performed when a variable is selected during the configuration phase. The variable's actual value is never displayed directly in the task configuration.

### Runtime Behavior

To ensure that automations always use the most current data, values are fetched dynamically at the time of execution. When a task starts, an initialization process retrieves up-to-date values for any used variables. This process guarantees that scheduled automations automatically receive changes, such as updated passwords, without manual reconfiguration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.