What is token vesting?
Token vesting is the practice of locking a token allocation and releasing it gradually over time, on a schedule enforced by a smart contract. Instead of handing a team member, investor or treasury its full allocation at launch, the tokens unlock in stages, often after an initial waiting period called a cliff. The schedule is set in advance and the contract releases only what has unlocked.
Vesting exists because token allocations are large and markets are thin at launch. If everyone who holds a founder, investor or advisor allocation could sell on day one, the price would collapse and the project's credibility with it. Vesting spreads those unlocks out, so supply enters the market in a predictable, disclosed way that holders can plan around.
Why does token vesting matter?
Token vesting matters because it protects price, builds trust and aligns incentives at the same time. By preventing large allocations from hitting the market at once, vesting smooths sell pressure and avoids the launch-day dump that sinks so many tokens. Because the schedule is public and on-chain, it also tells the community exactly when supply will unlock, which removes a major source of uncertainty.
Just as important, vesting aligns the people building and funding the project with its long-term success. A team whose tokens unlock over four years has every reason to keep delivering, and investors on a multi-year schedule are betting on durable value rather than a quick flip. A credible, verifiable vesting plan is now something serious buyers and exchanges expect to see before they take a token seriously.
What are the main token vesting models?
There are four common token vesting models, and most projects combine them. The right mix depends on who holds the allocation and what behavior you want to encourage. Each model is a different shape of release over time.
- Cliff vesting: nothing unlocks until a set date (the cliff), then a chunk releases at once. Used to ensure a minimum commitment before any tokens are earned.
- Linear vesting: tokens unlock in equal installments over the period, often per second or per block on-chain. This is the most common structure, used by roughly 70% of projects.
- Graded or monthly vesting: tokens unlock in steps, for example monthly or quarterly, rather than continuously.
- Milestone vesting: tokens unlock when specific goals are met. Less common because milestones are harder to encode and verify on-chain.
Most real schedules combine a cliff with linear or monthly release after it.
What is a token cliff?
A token cliff is an initial period during which no tokens unlock at all. When the cliff ends, the tokens that accrued during it become available, and regular vesting begins from there. A one-year cliff means the holder receives nothing for twelve months, then a first tranche unlocks and the rest follows on the chosen cadence.
The cliff is a commitment filter. For team allocations it ensures someone who leaves in the first year walks away with nothing, which protects the cap table. The one-year cliff has become the industry standard, used by roughly 85% of projects with team vesting schedules. Investor cliffs are usually shorter, in the range of six to twelve months.
What is a standard token vesting schedule?
The standard token vesting schedule for a team is four years with a one-year cliff: 25% of the allocation unlocks at the first anniversary, and the remaining 75% releases linearly over the following three years. This four-year, one-year-cliff shape carried over from startup equity and is now the default for crypto team and founder tokens.
Other allocations follow different norms, because each group takes on different risk and plays a different role.
| Allocation | Typical schedule | Typical cliff |
|---|---|---|
| Team and founders | 3 to 4 years | 1 year |
| Investors (early) | 12 to 18 months | 6 months |
| Investors (later rounds) | 2 to 3 years | 6 to 12 months |
| Advisors | 1 to 2 years | 3 to 6 months |
| Community and rewards | Released over program duration | Often none |
These are starting points, not rules. The goal is a schedule that matches the risk each group took and keeps total unlocked supply growing smoothly rather than in cliffs that shock the market.
How does on-chain token vesting work?
On-chain token vesting works by encoding the schedule in a smart contract that releases only the amount unlocked at the time of each claim. The holder, or the project on their behalf, calls the contract, which calculates how much has vested based on the start time, cliff and release rate, and transfers exactly that amount. Nothing unlocks early, because the math lives in the contract.
This is what makes on-chain vesting more trustworthy than an off-chain promise. Anyone can read the contract to see the schedule, the total allocation and how much remains locked, so the lock is verifiable rather than asserted. Pairing vesting with a token claim portal lets holders claim what has vested so far and come back as more unlocks, all in one branded flow. See how on-chain token vesting handles cliff, linear and monthly schedules.
Token vesting best practices
Good token vesting follows a few principles that protect both the project and its holders:
- Match the schedule to the role. Team and founders vest longest, investors shorter, with cliffs sized to the risk each took.
- Publish the schedule. Disclose every allocation and unlock date up front; surprise unlocks destroy trust faster than slow ones.
- Smooth the unlock curve. Avoid large simultaneous cliffs across allocations, which create predictable sell walls. The deeper mechanics are covered in crypto vesting explained.
- Enforce it on-chain. Use audited vesting contracts so the lock is verifiable and cannot be bypassed.
- Plan the distribution. Decide how vested tokens reach holders, usually a claim portal, before the first unlock.
Common token vesting mistakes
The most common token vesting mistakes are unlock cliffs that all land at once, schedules that are too short to signal commitment, and locks that exist only in a document rather than a contract. A single large unlock can erase weeks of price gains in a day, especially if the market did not see it coming. Short or absent team vesting tells buyers the team is not committed, which suppresses demand from the start.
The fix is straightforward: stagger unlocks so supply grows gradually, give team allocations a multi-year schedule, and enforce everything on-chain so the locks are real and auditable. Vesting is one of the clearest signals a project sends about its intentions, so it is worth getting right. Start with on-chain vesting on your own domain and the rest of the token mechanics follow.