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

> ## Agent Instructions
> Driven is a sales-compensation platform. Use its terminology: Compensation Plan, Compensation, KPI, Manual KPI, User Variable, Quota, Performance, Payout (Draft, Approved, Paid, Cancelled), Correction, Adjustment. Payout types are equal, deferred and advance. Default roles are Admin and Employee; companies can add custom roles. The Driven Agent builds plans from uploaded documents and chat. The Compensation Builder is where compensations are configured.

# Manage user variables

> Set Base Salary, Variable Salary and custom amounts per person, with an effective date for each change.

User variables are per-person amounts a [formula](https://docs.driven.work/compensation-builder/formulas.md) can use. They follow the person across plans. Base salary is the usual one.

Open the person from **Users & Teams**. Their page has **Details & Variables**, **Payouts**, **Compensations** and **History**. A CRM user shows **Linked to CRM**. Name and email are read-only for that person.

![Person page with Details and Variables, a Linked to CRM badge, and the Plans table](https://mintcdn.com/driven-a7b16d8c/EfofHHnWRF2nRMlf/images/user-details.png?fit=max\&auto=format\&n=EfofHHnWRF2nRMlf\&q=85\&s=c0826e85f6c472035be39d6480059c08)

## Edit values

On **Details & Variables**, the **Variables** table has **Variable**, **Effective from** and **Value**.

**1. Add or edit a row**

Add a dated value, or change an existing one. **Base Salary** and **Variable Salary** are always available. Custom variables appear here after you create them in the [formula editor](https://docs.driven.work/compensation-builder/user-variables.md).

**2. Pick the date it starts**

**Effective from** is the first day this amount applies. It cannot be in the future. The previous amount stays in the history and still applies before this date.

**3. Save**

Click **Save changes**. Leaving with unsaved edits asks you to **Stay** or **Leave**.

## When a payout was already paid

If the new value would change an approved or paid payout, Driven opens **Review changes** before it saves. You see who is affected and choose a recovery method, the same choice as when you publish a compensation. See [Corrections](https://docs.driven.work/compensation-builder/corrections.md).

The locked payout is not rewritten. The difference is settled on a later payout.

Which dated value a calculation uses depends on the compensation. A totals compensation uses the value at the end of the payout period. A row-based compensation uses the value on the date each deal counts. The full rule is on [User variables in the builder](https://docs.driven.work/compensation-builder/user-variables.md).

## History

**History** lists each change, for example **Base Salary was set to €4,000** or **Base Salary changed from €4,000 to €5,000**, with a badge such as **Salary updated**.

![History tab listing variable changes with a date, description and type](https://mintcdn.com/driven-a7b16d8c/EfofHHnWRF2nRMlf/images/user-history.png?fit=max\&auto=format\&n=EfofHHnWRF2nRMlf\&q=85\&s=d4848014576e8483f3fe99b789336de8)

**Plan Join Date** is edited per plan, not in this table. Use the **Plans** table on the same page, or the plan's people tab. See [Plan membership](https://docs.driven.work/users/plan-membership.md).


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