> For the complete documentation index, see [llms.txt](https://documentation.civalgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.civalgo.com/documentation/operations/time-off-configuration.md).

# Time Off Configuration

Manage your team's time off directly in Civalgo. Set up absence types, track balances, and avoid assigning an absent employee in the Dispatcher.

{% hint style="info" %}
You'll find the module in the left navigation bar: **Management → Time Off**
{% endhint %}

#### 1. Configuration

| <p>Who: Administrators only</p><p>Where: Time Off → Configuration tab</p> |
| ------------------------------------------------------------------------- |

Configuration is done in two steps: create the categories (the types of absence), then create the policies linked to those categories (the rules associated with each category).

**1.1 Categories**

A category represents a type of absence (e.g., Vacation, Sick leave, Unpaid leave).

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FsUOOhreLXpl7cc9n4sM2%2Fimage.png?alt=media&amp;token=c2cf7265-8217-4e46-9838-08209f8095e3" alt=""><figcaption></figcaption></figure>

**Create a category**

1. Go to **Time Off → Configuration → Categories**.
2. Click **+ New category** in the top right.
3. Fill in the fields:
   * **Name** — the name displayed throughout the app
   * **Icon** — the icon associated with the category
4. Click **Create new time off category**.

**Edit or archive a category**

* Pencil icon → rename or change the icon
* Folder icon → archive the category

{% hint style="info" %}
To view archived categories, click the three dots (⋯) in the top right of the list.
{% endhint %}

**1.2 Policies**

A policy defines how time off is granted for a given category. A single category can have several policies — for example, an accrued-days policy for unpaid leave, and a fixed-days policy for sick leave and vacation.

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FDA94s5KeuRXxv5hncWGE%2Fimage.png?alt=media&amp;token=937ffff1-7a9c-4c3b-a8c5-72a198e4fe4c" alt=""><figcaption></figcaption></figure>

| **Type**                | **When to use it**                                               |
| ----------------------- | ---------------------------------------------------------------- |
| Fixed days (manual)     | Balances are added and deducted manually by the admin            |
| Accrued days (flexible) | Days accumulate automatically; requests are recorded and tracked |

**Create a policy**

1. Go to **Time Off → Configuration → Policies**.
2. Click **+ New policy**.
3. Choose the **policy type**.
4. Give it a **name** and link it to a **category**.
5. Click **Create new time off policy**.

{% hint style="info" %}
The Category field is locked after creation. To change the category, archive the policy and create a new one.
{% endhint %}

**Edit or archive a policy**

* Pencil icon → rename
* Folder icon → archive

{% hint style="info" %}
To view archived policies, click the three dots (⋯) in the top right of the list.
{% endhint %}

**1.3 Assign employees to a policy**

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FHZpLwawDv2zDN33d7liM%2Fimage.png?alt=media&amp;token=d2c257d7-1195-4b57-abd6-f635f5f8cebb" alt=""><figcaption></figcaption></figure>

1. In the list of policies, click the policy name.
2. Click **+ Add employees**.
3. Select one employee, several, or the entire list.
4. Click **Add employees**.

To remove an employee: click ⋯ to the right of their name → **Remove from policy**.

{% hint style="info" %}
An employee can belong to several policies, as long as they're in different categories. They can't be enrolled in two policies from the same category.
{% endhint %}

**1.4 Manage balances (fixed-days policies)**

Fixed-days policies display a **Balance** column on the details page.

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FRkLJgc0Xy4LaKKUOg5X6%2Fimage.png?alt=media&amp;token=37b3d8d4-0c17-45ef-97a7-a4fa1f0332f4" alt=""><figcaption></figcaption></figure>

**Add or update a policy's balance for all employees**

1. Check the boxes to the left of the employees (or the header box to select everyone).
2. Click **Update balance** in the bar that appears at the bottom.
3. The change applies to all selected employees.

**Update an individual employee's balance**

1. Click ⋯ to the right of the employee → **Update balance**.
2. Choose how to change it:

   | **Mode** | **Effect**                                           |
   | -------- | ---------------------------------------------------- |
   | Set      | Replaces the current balance with the amount entered |
   | Add      | Adds the amount to the current balance               |
   | Remove   | Subtracts the amount from the current balance        |
3. Add a note (optional) — it appears in the employee's history.
4. Review the summary at the bottom of the dialog, then click **Confirm**.

#### 2. Record a time off request

| Where: Time Off → Requests → + Record time off |
| ---------------------------------------------- |

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2F7HmHXD1wsXXXdhP65EOo%2Fimage.png?alt=media&amp;token=7ed5a280-680e-4e93-8945-9e2645d5431e" alt=""><figcaption></figcaption></figure>

1. Select the employee.
2. Choose the category.
   * Only categories linked to one of the employee's policies are available.
3. Enter the period (start and end date).
4. Adjust the number of days if needed.
   * Each day is pre-filled with 1 for working days and 0 for weekends.
   * Enter 0 to exclude a specific day.
5. Add a note (optional).
6. Click **Record time off**.

The request immediately appears as approved in the **Requests** tab. The days are deducted from the balance (fixed-days policies) or simply recorded (accrued-days policies).

{% hint style="info" %}
Tip: Fill in the dates first — the day-by-day grid is generated automatically, and you can adjust each day before confirming.
{% endhint %}

#### 3. Day-to-day use

**3.1 My dashboard — personal view**

| <p>Who: All employees</p><p>Where: Time Off → My dashboard</p> |
| -------------------------------------------------------------- |

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FW0h1QJDr79bZgflma2Xg%2Fimage.png?alt=media&amp;token=5ba7a46f-d1bc-471b-b535-f43f70509156" alt=""><figcaption></figcaption></figure>

Each employee sees their own situation here, divided into three sections:

* **Balance cards** — one card per assigned policy, showing the days available or "Unlimited," depending on the policy
* **Upcoming time off** — a chronological list of upcoming approved time off and statutory holidays
* **History** — a complete log of balance changes and time off periods

**3.2 Admin dashboard — overview**

| <p>Who: Managers and administrators</p><p>Where: Time Off → Admin dashboard</p> |
| ------------------------------------------------------------------------------- |

<figure><img src="https://4134278745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxU6tqvHV93MebTO1c9hv%2Fuploads%2FM3md8tsAmMSUT5mzheuU%2Fimage.png?alt=media&amp;token=611f17f7-fe3e-429e-acad-d5c54fa75c97" alt=""><figcaption></figcaption></figure>

The same view as the personal dashboard, but for all employees. Each row shows the name, occupation, organization, team, and upcoming time off.

* Use the search bar or sort by column to find an employee.
* Click **View** or an employee's name to open their individual dashboard and edit their balances directly.
* The **Settings** button lets you show or hide columns.

**3.3 Requests — request log**

| <p>Who: Managers and administrators</p><p>Where: Time Off → Requests</p> |
| ------------------------------------------------------------------------ |

All recorded time off periods are listed here. Each row shows:

* The employee, category, dates, number of days, and status
* Who approved and who created the request

**Edit an existing request**

Click the pencil icon to the right of the row → edit the fields you want → **Update time off request**.

**Archive a request**

Click the folder icon to the right of the row.

**Other access points**

| **Access point**                                            | **Action**                         |
| ----------------------------------------------------------- | ---------------------------------- |
| Requests → + Record time off                                | Full form                          |
| My dashboard / Admin dashboard → pencil on the balance card | Record linked to a specific policy |
| Admin dashboard → employee row → balance card               | Admin-side record for a colleague  |
