> For the complete documentation index, see [llms.txt](https://docs.dozer.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dozer.finance/project-launch-tools/token-claiming.md).

# Token Claiming

Token claiming is the user-facing side of vesting and Launchpad sales — it's how beneficiaries and buyers actually receive the tokens that have been allocated to them on-chain.

This page is a concept overview for project creators. **End users** should use the dedicated user guides:

* [🪙 Claiming Vested Tokens](/user-guides/claiming-vested-tokens.md) — for vesting beneficiaries (team, advisors, ecosystem allocations)
* [🔥 Participating in a Token Sale](/user-guides/participating-in-token-sale.md) — for Launchpad sale buyers (includes the claim step after a successful sale)

## Two Claim Surfaces

Dozer Tools exposes claiming in two different places, depending on where the allocation came from.

### 1. Vesting claims — Token Vesting section

For tokens distributed through your project's **vesting plan** (team, advisors, ecosystem reserves, custom investor allocations).

* **Where**: The public token page at `/tokens/<token-id>`, in the **Token Vesting** section.
* **Tabs**: Allocations (claim here), Distribution (visualization), Vesting Schedule (timeline).
* **Status states**: Cliff Period, Vesting in Progress, Available to Claim, Nothing to Claim, Fully Claimed.
* **Per-row claim**: Each beneficiary row has its own Claim button.

### 2. Launchpad claims — Public sale page

For tokens purchased through a **Launchpad crowdsale**.

* **Where**: The public sale page at `/launchpad/<token-id>`, in the **Your Participation** panel.
* **Available after**: The project owner finalizes a Successful sale.
* **Failed sale**: Same panel exposes a **Refund** button instead, returning HTR to the buyer.

## What Project Creators Should Know

* You don't claim on behalf of beneficiaries — they claim themselves.
* Beneficiaries claim **per allocation**, **per project**. Cross-project bulk claiming is not supported.
* Each claim costs the beneficiary a small HTR transaction fee. Most users batch claims rather than claiming every unlock cycle.
* The status badges and progress bars on the Token Vesting tab update automatically — beneficiaries can use the page as a read-only monitor.

## What to Tell Your Beneficiaries

When onboarding a new beneficiary group (team, advisors, investors), include in your communication:

1. The **token contract address** (or public token page URL: `/tokens/<token-id>`)
2. The **exact Hathor address** you registered as their beneficiary
3. A link to the [Claiming Vested Tokens](/user-guides/claiming-vested-tokens.md) guide
4. The **cliff and vesting duration** so they know when to expect first unlocks

## Related

* [Vesting Configuration](/project-launch-tools/vesting-configuration.md) — where beneficiary addresses and schedules are set
* [Crowdsale](/project-launch-tools/crowdsale.md) — sale management; the buyer claim flow is in the user guide
* [Claiming Vested Tokens (User Guide)](/user-guides/claiming-vested-tokens.md)
* [Participating in a Token Sale (User Guide)](/user-guides/participating-in-token-sale.md)