# Vesting

Vesting lets restricted shares be earned over time or by milestones.

## Create a schedule

Choose **Issue Shares**, pick the recipient, class and amount, then set the vesting:

- **Time-based**: a preset such as **Employee** or **Advisor**, a **Lockup**, or **Custom** with your own start, cliff, length and cadence.
- **Milestones**: for each milestone, a share amount, a due date and an optional document.

Turn on **Revocable** if the company may cancel unvested shares, or milestones not yet approved. Options and other awards vest with their grant, under [Grants](https://obolos.io/help/company-grants.md).

## Read the page

**Schedules** lists each holder with the terms, what has vested and what comes next. Amounts stay sealed until you choose **Unlock amounts**. **Unlock timeline** shows what vests when, by class. Schedules released in full, or whose milestones were all cancelled, move to **Finished**, and revoked ones to **Revoked**.

## Review a milestone

When a holder marks a milestone complete, it waits for you under **Milestones** with any evidence they attached.

- **Approve** makes that milestone's shares releasable.
- **Reject** records your decision document, and the holder can submit again.
- **Cancel** removes the milestone for good and returns its shares to escrow.

## Accelerate or revoke

Both sit in a schedule's row menu. **Accelerate vesting** moves a time-based schedule forward by a number of months, up to full vesting. It adds up and cannot be undone. **Revoke** stops future vesting on a revocable schedule and returns the unvested shares to escrow. What has vested stays claimable.

> If an agreement calls for acceleration when someone leaves, accelerate first: a revoked schedule cannot be accelerated.

## What the holder does

Holders see their schedules under Equity › Vesting schedules in their portfolio. They submit milestone evidence and release vested shares themselves. See [Vesting schedules](https://obolos.io/help/portfolio-vesting.md).

## Related

- [Vesting](https://obolos.io/help/vesting.md)
- [Grants & warrants](https://obolos.io/help/company-grants.md)
- [Cap table & share classes](https://obolos.io/help/company-ownership.md)
