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

# Custom Variables

> Computed fields that extend the data available within a hiring flow

Custom variables are computed fields that extend the data available within a hiring flow. They let you derive new values from existing application data without requiring candidates to enter additional information.

***

## Variable Types

| Type                       | Description                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Aggregated**             | Compute values across all applications or contracts — count, sum, average, minimum, or maximum                           |
| **Annotated (Functional)** | Compute values for a single application using functions like sum, min, max, mean, mode, or median across selected fields |
| **Annotated (Rule-Based)** | Compute values based on rule evaluation results                                                                          |

***

## Use Cases

| Example            | Type       | Description                                                  |
| ------------------ | ---------- | ------------------------------------------------------------ |
| Total applications | Aggregated | Count how many applications a candidate has across all flows |
| Quiz score         | Functional | Calculate the average score across multiple quiz questions   |
| Risk rating        | Rule-Based | Assign a risk level based on rule evaluations                |