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

# How To Cancel Allocations

> Cancelling stops an allocation's on-chain distribution and returns any unclaimed tokens to your admin wallet. Sync the claim state first, decide what happens to unclaimed tokens, and sign the cancellation on-chain.

Cancelling an allocation stops its ongoing distribution. Any tokens that have **not** yet been claimed are returned to your project's admin wallet; tokens the recipient has already claimed always stay with them.

<Note>
  Cancel is one of three related actions — pick the right one:

  * **Cancel** *(this guide)* — an *on-chain* action for allocations you have already funded. It stops the contract from distributing further and reclaims unclaimed tokens.
  * **Delete** — an *off-chain* action for allocations you have **not** funded yet. It simply removes the allocation from Magna. See [How To Edit & Delete Allocations](/admins/product-guides/how-to-add-and-edit-allocations/how-to-edit-and-delete-allocations-and-stakeholders).
  * **Schedule a cancellation** — set a future date for a Direct Transfer (Airdrop) allocation to cancel automatically. See [How To Schedule Cancellation of Allocations](/admins/product-guides/how-to-add-and-edit-allocations/how-to-schedule-cancellation-of-allocations).
</Note>

## Before you cancel: sync the claim state from chain

Cancellation only reclaims tokens that are still **unclaimed**. A recipient can keep claiming right up until the cancellation transaction is signed, so before you cancel, sync the allocation so Magna reflects the latest claimed amounts from the blockchain. This makes sure the amount returned to your admin wallet is accurate.

1. Open the allocation you plan to cancel.

   <img src="https://mintcdn.com/magna-bc9e7a48/SeGSLSh_CDKBi4c3/images/admins/allocation-details-page.png?fit=max&auto=format&n=SeGSLSh_CDKBi4c3&q=85&s=077d1a2ec552e35c2777ef6761da4c00" alt="" width="1050" height="878" data-path="images/admins/allocation-details-page.png" />

2. Click **Sync allocation state from chain** (the refresh icon in the top-right actions).

   <img src="https://mintcdn.com/magna-bc9e7a48/1I46JjC3yPqketmg/images/admins/cancel-allocations/sync-allocation-state.png?fit=max&auto=format&n=1I46JjC3yPqketmg&q=85&s=68f860c20fe52dc8b9fb0b1d85b0a077" alt="" width="1272" height="288" data-path="images/admins/cancel-allocations/sync-allocation-state.png" />

<Note>
  The sync action is available only for **Claim** allocations that have been started on-chain. Direct Transfer (Airdrop) allocations don't have an escrow contract to read claim state from, so they don't show this action.
</Note>

<Warning>
  If a recipient has already claimed **all** of their tokens, syncing marks the allocation as **Completed** — and completed allocations can no longer be cancelled, because there is nothing left to reclaim.
</Warning>

## What happens to the tokens

When you cancel:

* **Already-claimed tokens** stay with the recipient — cancellation never claws these back.
* **Unclaimed tokens** are handled based on the option you choose below.
* Optionally, set a **termination date** to backdate the cancellation. Tokens are treated as vested only up to that date and time.

## Choose what happens after cancellation

When you cancel, choose one of two options for the tokens that haven't been claimed yet:

* **Reclaim unclaimed + stop future transfers** *(default)*
  * *Claim:* all unclaimed tokens are clawed back to your admin wallet.
  * *Direct Transfer:* no further tokens are distributed.
* **Allow claims + continue vested distributions**
  * *Claim:* recipients can still claim tokens that have already vested — nothing is clawed back.
  * *Direct Transfer:* already-vested tokens continue to be distributed on the original schedule.

<Note>
  The "Allow claims + continue vested distributions" option may need to be enabled for your token by the Magna team. If you don't see the choice, reach out to us.
</Note>

## Set a termination date (optional)

You can backdate the cancellation to an effective date — for example, an employee's last day. Vesting is calculated up to that date and time (UTC), and anything that would have vested afterwards is treated as unvested and reclaimed. The termination date must be in the past.

## Cancel an allocation

1. Go to the **Allocations** tab and select the allocation(s) you want to cancel.

2. Click **Actions** in the top right-hand corner and choose **Cancel**.

   <img src="https://mintcdn.com/magna-bc9e7a48/SeGSLSh_CDKBi4c3/images/admins/allocation-actions.png?fit=max&auto=format&n=SeGSLSh_CDKBi4c3&q=85&s=c810bf92451f4318bdd7db2f518ed8f2" alt="allocation actions" width="2560" height="1446" data-path="images/admins/allocation-actions.png" />

3. Review the summary and, optionally, set a termination date and time. If the "allow claims" option is enabled for your token, you'll also choose what happens to unclaimed tokens here.

   <img src="https://mintcdn.com/magna-bc9e7a48/1I46JjC3yPqketmg/images/admins/cancel-allocations/cancel-modal.png?fit=max&auto=format&n=1I46JjC3yPqketmg&q=85&s=10920175e6b5bef6649f07230e2e1f0a" alt="" width="968" height="882" data-path="images/admins/cancel-allocations/cancel-modal.png" />

4. Click **Yes, cancel allocations.**

5. Sign the cancellation transaction where required:

   * **Claim** allocations that were already funded on-chain need a signed **Cancel Distribution** transaction. Go to the **Transactions** tab and sign it using the same wallet address you used to fund them.
   * **Direct Transfer** allocations that haven't gone on-chain — and **Claim** allocations that were never funded — are cancelled immediately, with no transaction to sign.

   <img src="https://mintcdn.com/magna-bc9e7a48/1I46JjC3yPqketmg/images/admins/cancel-allocations/sign-cancel-transaction.png?fit=max&auto=format&n=1I46JjC3yPqketmg&q=85&s=547286b635a497d8cafe9a2916399d6b" alt="" width="3008" height="1292" data-path="images/admins/cancel-allocations/sign-cancel-transaction.png" />

Once the cancellation is complete, the allocation shows the **Cancelled** status.

## Which allocations can be cancelled

An allocation **cannot** be cancelled if any of the following are true:

* It is already **Cancelled** or **Completed** (fully claimed).
* Its distribution was configured to be non-cancellable (immutable). Configuring a distribution as un-cancellable is done with the Magna team given the risks involved.
* A cancellation is already in progress for it (a Cancel Distribution transaction is awaiting signature or being processed).

If you need help with a cancellation, contact us at [support@magna.so](mailto:support@magna.so).
