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

# Managing Vesting Schedules

> Configure and manage vesting schedules for token grants

## Overview

Vesting schedules determine when recipients earn their tokens. TGA provides pre-built templates and a custom vesting builder.

***

## Pre-Built Templates

| Template                 | Cliff            | Vesting                     | Total     |
| ------------------------ | ---------------- | --------------------------- | --------- |
| **4-Year, 1-Year Cliff** | 25% at 12 months | 2.08% monthly for 36 months | 48 months |
| **3-Year, No Cliff**     | None             | 2.78% monthly               | 36 months |
| **2-Year Quarterly**     | None             | 12.5% per quarter           | 24 months |
| **1-Year Monthly**       | None             | 8.33% monthly               | 12 months |

***

## Creating a Vesting Template

<Steps>
  <Step title="Navigate to Vesting Schedules">
    Go to **Vesting Schedules** in the sidebar.
  </Step>

  <Step title="Click Create Template">
    Select **Create Template** to open the builder.
  </Step>

  <Step title="Choose a preset or custom">
    Pick a pre-built template or select **Custom** to define your own tranches.
  </Step>

  <Step title="Configure tranches">
    For custom schedules, define each vesting tranche:

    * **Percentage** — What portion of the grant vests
    * **Time period** — When the tranche vests (months from start)
    * **Type** — Cliff (all-at-once) or linear (gradual)
  </Step>

  <Step title="Save">
    Name the template and save for reuse across grants.
  </Step>
</Steps>

***

## Vesting Parameters

| Parameter            | Description                       | Options                      |
| -------------------- | --------------------------------- | ---------------------------- |
| **Vesting Period**   | Total months for full vesting     | 1–120 months                 |
| **Cliff**            | Initial waiting period            | 0–24 months                  |
| **Cliff Percentage** | Percentage that vests at cliff    | 0–100%                       |
| **Frequency**        | How often tokens vest after cliff | Monthly, Quarterly, Annually |

***

## How Vesting Works

### Example: 4-Year with 1-Year Cliff

For a 10,000 token grant starting January 2026:

| Date     | Event            | Tokens      | Cumulative |
| -------- | ---------------- | ----------- | ---------- |
| Jan 2026 | Grant starts     | 0           | 0          |
| Jan 2027 | **Cliff vests**  | 2,500 (25%) | 2,500      |
| Feb 2027 | Monthly vest     | \~208       | 2,708      |
| Mar 2027 | Monthly vest     | \~208       | 2,917      |
| ...      | ...              | ...         | ...        |
| Jan 2030 | **Fully vested** | \~208       | 10,000     |

***

## Unified Schedule Manager

The Schedule Manager provides a single view of all vesting and distribution activity across 6 tabs:

1. **Distribution Config** — Set FMV mode and variance thresholds
2. **Pending Approval** — Approve vesting events as they occur
3. **Tax Grouping** — Assign tax details to approved vestings
4. **Tax Finalization** — Review and finalize tax calculations
5. **Ready for Settlement** — Vestings eligible for distribution
6. **Settlements** — Pending and completed settlements

***

## Modifying Vesting

* **Before acceptance**: Vesting schedules can be changed freely
* **After acceptance**: Terminate the grant and create a new one with updated terms
* **Bulk updates**: Use [Bulk Upload](/tga/client/bulk-upload-grants) → **Bulk Update Vesting Tranches** tab

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Token Distributions" icon="share-nodes" href="/tga/client/token-distributions">
    Process vested tokens
  </Card>

  <Card title="Settlements" icon="file-invoice-dollar" href="/tga/client/settlements">
    Full settlement workflow
  </Card>
</CardGroup>