# Run a corporate action

Source: https://docs.settlemint.com/docs/console/asset-management/manage/run-a-corporate-action
Choose the event, enter its terms and record it, then review the allocation for each holder, run it, and check what the tab shows afterwards.

Use this workflow to record terms, review per-holder allocations, and run a corporate action from an asset's **Actions** menu or **Corporate actions** tab. Check feature requirements, role gates, and custody freeze rules on [Corporate actions](https://docs.settlemint.com/docs/console/asset-management/manage/corporate-actions#before-you-start) before starting.

![The Actions menu of an equity, opening with the Corporate actions group](https://docs.settlemint.com/docs/screenshots/console-manage-asset-menu.light.en.webp)

[Screenshot] The Actions menu lists the Corporate actions group first, then the asset's other controls, and the group opens a submenu of the events the asset can run.

## Before you start [#before-you-start]

- Hold the required asset role on your signing wallet (Governance for cash payouts and program links, Supply management for supply-changing runs and in-kind payouts, plus Permission manager for splits on priced shares).
- Confirm the asset is active (for supply-changing runs) and no overlapping run occupies its in-flight slot.
- Have approved terms ready in display units (never pre-scale by decimals, because the Console converts display amounts to base units).

## Steps [#steps]

### Choose the event [#choose-the-event]

1. Open **Assets**, then **All assets**, select the asset, and open **Actions**, then **Corporate actions** (or select **Start** on a row under **Start a corporate action** on the **Corporate actions** tab).
2. Choose the event type. Program links (**Bond coupon**, **Maturity redemption**, **Conversion**) complete immediately on one PIN and link to their feature tabs. Declarations (**Cash dividend**, **Distribution**, **Coordinated distribution**) follow [Cash dividend and distribution](https://docs.settlemint.com/docs/console/asset-management/manage/cash-dividend) and [Coordinated distribution](https://docs.settlemint.com/docs/console/asset-management/manage/coordinated-distribution).

### Enter terms and record the event [#enter-terms-and-record-the-event]

3. On **Terms**, enter the approved ratios, holder allocations, optional record date, optional cash payout, or optional holder election (**Let holders choose before a deadline**). Nothing is stored yet, and leaving discards the draft.
4. Select **Review holders** (or **Review N holders** on holder-book events) to compute per-holder allocations without signing.
5. On **Review**, compare the summary strip, holder table (exportable as CSV), and any **Rights issue close** or **Excess applications** card against your approval. Tick any required risk acknowledgements.
6. Select the main action button (for example **Split shares**, **Burn shares**, **Issue bonus shares**, or **Send for approval** when a second signature is required) and confirm with wallet verification.
7. If approval or a holder election applies, wait for the decision or election deadline, reopen the run from **In flight**, re-tick acknowledgements, and confirm with your PIN to execute.
8. Keep the record page open through **Progress** until status reaches a terminal state ("Settled", "Cancelled", or "Releasing custody"), then verify results in **History** and **Holders**.

### Review, then run it [#review-then-run-it]

On **Review**, the summary strip shows **Holders receiving** (or **Holders giving up shares** on burn-only runs), supply before and after, **Snapshot** ("Live register" or UTC record date), **Recorded share price** (on splits with a price feed), **Gets nothing** (holders rounding to zero), and **Approval** ("Needs a second person" when required).

- The holder table lists positive-allocation holders (25 per page) with **Before**, **After**, **Change**, and **Export**. Rows tagged "rounded down" or "left out" carry a **Why** menu item explaining the outcome.
- If balances change while **Review** is open, DALP blocks execution, refreshes the figures with "Holdings changed since you opened this review. Check the new figures.", clears ticked acknowledgements, and waits for a fresh confirmation.
- If balances move after a stored preview ("The holder book moved after the preview"), cancel before execution and start a new action, or select **Stop execution** if batches already landed and continue with a follow-up run.
- While a holder election is open, the record displays "Holders can choose until" with a disabled **Review after** button, and locks **Preview again** once any holder chooses or the deadline passes. After close, **Review** shows an **Option** column and outcome totals before execution.

![Review step of a 1-for-10 bonus issue with the summary strip and the holder table](https://docs.settlemint.com/docs/screenshots/console-corporate-action-preview.light.en.webp)

[Screenshot] The page is titled Bonus issue · Capped Tech Shares, with the Terms, Review and Progress steps.

## Terms by event family [#terms-by-event-family]

### Ratio events (bonus issue, stock split, reverse split, rights issue, spin-off, in-kind payouts) [#ratio-events-bonus-issue-stock-split-reverse-split-rights-issue-spin-off-in-kind-payouts]

Enter a whole-number ratio (or switch **Enter the ratio as** to **Percentage**, up to four decimals, stored internally as an exact ratio) and an optional record date (required in the future when custodial contracts hold the token).

| Event | Extra fields and rules |
| --- | --- |
| **Stock split** / **Reverse split** | **Split direction** must match the ratio (more new shares for **Split**, fewer for **Reverse split**, with 1:1 / 100% refused). Reverse splits also set **Fractions** (**Round down**, **Whole shares**, or **At least one share**) and optional **Pay cash for fractions** (denomination asset and **Price per token** paid by the active smart-wallet treasury). |
| **Rights issue** | Pick **Rights issue action**: **Mint rights now**, **Through an existing sale** (whitelists holders onto an existing sale without minting), **Tradable rights token** (requires an empty organisation token with Hold, matching decimals, Supply management, and a qualifying **Subscription payee**), or **Close a rights issue** (burns lapsed rights, issues shares, and settles any **Excess applications** pro rata from lapsed rights with cash refunds). |
| **Spin-off** | Requires an empty candidate child token carrying share or unit capital, not part of another multi-class instrument, on which you hold Supply management. |
| **In-kind payouts** | **Stock dividend**, **Bond coupon paid in tokens**, and **Distribution paid in tokens** mint a floored ratio of new units to each holder and use the in-flight slot. |

A **Tradable rights token** issue also requires a **Subscription payee**: the organisation account that receives subscription payments and exercised rights. The field lists qualifying organisation accounts on the token's network, such as its Smart Wallet or an organisation-owned [treasury multisig](https://docs.settlemint.com/docs/concepts/custody-and-signing/multisig#a-treasury-the-organisation-owns), and accepts a pasted address. The declaring wallet is omitted, and a member's own wallet or person-owned multisig is refused on record. When approval is on, the second approver approves the payee with the plan.

### Holder-book events (capital decrease, partial redemption, buyback) [#holder-book-events-capital-decrease-partial-redemption-buyback]

These events burn units directly from selected holders without holder signatures. Use the holder-book editor to select rows, prefill pro rata from **Total to burn**, edit or exclude rows, or round-trip via CSV export/import until allocations balance to the declared total. Amount and price fields accept `k`, `m`, and `b` suffixes (for example `1.5k` = 1,500).

- **All-holders buyback**: Switch **Who** to **All holders** to call every holder at one cash price. On assets with dividend yield, Governance holders can use **Compute call price** and **Use this price** to calculate target-return pricing net of paid dividends.
- **Cash payment on partial redemption**: Select **Add a cash payment**, pick a **Denomination asset**, and enter **Price per token** (paid from the active smart-wallet treasury).

### Holder elections [#holder-elections]

On supported supply changes and in-kind payouts, switch on **Let holders choose before a deadline**, set **Holders can choose until** (UTC), and configure at least two options (exactly one marked "Gets the allocation" and one marked **Default**). Holders submit or update choices on their holding page with **Save choice** until the deadline. Cash-paying buybacks, cash partial redemptions, reverse splits paying cash for fractions, sale-based rights issues, and rights-issue closes cannot carry elections.

## Restricted wallets, frozen holders, and continuing partial runs [#restricted-wallets-frozen-holders-and-continuing-partial-runs]

Holders under a [wallet restriction](https://docs.settlemint.com/docs/console/participants/restricted-wallet-burns#burns-and-corporate-actions) or address freeze are evaluated at confirmation, so **Review** still lists them beforehand.

| Action kind | Behaviour for restricted or frozen holders | How to finish later |
| --- | --- | --- |
| **Minting events** (bonus, forward split, in-kind payout, rights allotment, rights-close shares, reverse-split top-ups) | Skips holders frozen on the minted token ("Restricted wallet: left out" or "Frozen wallet: left out"). Refuses if every holder is skipped. Spin-offs and tradable rights issues cannot be continued and refuse confirm if any holder is frozen. | Lift the freeze/restriction, then select **Continue this action** on the completed record. |
| **Buyback** / **Partial redemption** | Leaves restricted holders out without burning or paying cash (`DALP-9590` if all holders are restricted). Paying treasury must still cover the full plan. | Lift the restriction, then select **Continue this action**. |
| **Reverse split**, **Capital decrease**, **Rights-issue close** (lapsed-rights burn) | On DALP 3.2 token contracts, burns restricted holders in place only when run from a smart wallet holding both **Supply management** and **Custodian** (withholding any fractional cash as "Restricted wallet: cash withheld"). Otherwise leaves them out ("Restricted wallet: left out"). Excess-application refunds to frozen wallets stay "Frozen wallet: refund withheld". | Lift the freeze/restriction, then select **Continue this action** to pay withheld cash/refunds or settle remaining holders. |

**Continue this action** appears on stopped runs with remaining holders and on completed runs with skipped holders or withheld cash/refunds (prefilling terms and showing "N holders left; M already applied" on **Review**). It is unavailable once already continued ("This run was already continued."), while another run is in flight, or on spin-offs.

[Figure] The event type picks the path: supply changes review then run on one PIN, declarations record then preview, program links complete on record. Choosing an event starts one of three paths. A supply change or a payment in tokens opens Terms, then Review, which reads the holders and stores nothing. One PIN on the main button creates the record and runs it, or sends it for approval first. Cancel closes the sheet before the PIN, and stopping a run cannot reverse applied changes. A cash dividend, a distribution paid in cash, and a coordinated distribution are recorded first, then previewed and confirmed. Recording a cash dividend or distribution already creates its on-chain obligation. Bond coupon, maturity redemption, and conversion records complete on record. Holders use their existing programs. Reopen an unfinished record from the In flight card. Labels: Event sequence; Choose the event; Supply changes; and payments in tokens; Terms, then Review; One PIN runs it; Review stores nothing until the PIN.; Stopping cannot undo applied changes.; Three event types; bond coupon, maturity redemption,; and conversion; Completes on record.; No Preview, Confirm, or; Cancel button appears.; Each is a holder claim against; a program, not a batch to preview.; Cash dividend, distribution, coordinated distribution:; record, then preview, then confirm.

The chosen event takes one of three paths: review then one PIN, record then preview and confirm, or a single record
that completes it.

## You should see [#you-should-see]

- On the **Corporate actions** tab, finished runs move from **In flight** into **History** with a terminal status ("Settled", "Cancelled", "Rejected", or "Recorded").
- Unfinished runs stay resumable in **In flight** via **Resume**, **Review**, or **View**, displaying "Declared", "Waiting for approval", "Running", and "Done".
- Left-out holders and withheld fractional cash appear in their exportable breakdown (with `restricted` or `frozen` in the CSV `reason` column), and failed batches list under **Holders not updated** with **Continue this action**.
- Minted, burned, or paid amounts in the record match **Holders** and your approval.

## Troubleshooting [#troubleshooting]

**Review fails to load holders**

**Signal:** **Review** displays an error reference and "The platform refused this review. The message above says what
to change." **Cause:** Invalid terms (such as an un-rebasable share price or missing balance history for a past record
date) or a transient read error. **Fix:** Select **Retry** if offered, or select **Change terms** to adjust the inputs
before retrying.

**The ratio is refused on a stock split or reverse split**

**Signal:** **New shares** rejects the ratio and keeps **Review** closed. **Cause:** A forward split requires more new
shares than old (above 100%), a reverse split requires fewer (below 100%), and 1:1 / 100% is refused in both
directions. **Fix:** Correct the ratio or switch **Split direction**.

**A candidate token is disabled in Rights issue or Spin-off**

**Signal:** A token cannot be selected in **Rights token** or the spin-off child selector. **Cause:** The candidate
already has supply, uses wrong decimals or capital type, lacks the Hold feature (rights token), belongs to another
multi-class instrument, or lacks your Supply management role. **Fix:** Read the inline reason on the disabled
candidate, issue a clean token first, or grant Supply management.

**Other corporate action errors**

**Signal:** Snapshot drift, partial batch stops, frozen balances, or treasury shortfalls. **Cause:** Operational state
changed or prerequisites were unmet. **Fix:** See the full list under [Corporate actions
troubleshooting](https://docs.settlemint.com/docs/console/asset-management/manage/corporate-actions#troubleshooting).

