What Is the Pausable Token Extension on Solana?

Most token extensions add something. Transfer fees add a cut, interest-bearing adds an accrual curve. Pausable is the one that takes something away — temporarily — which is why it gets misread so often. It is not the freeze authority, it is not permanent, and it is not something you can add to a token later. Here is what it actually does.

TL;DR

• The pausable extension (PausableConfig) lets a nominated pause authority halt activity across an entire Token-2022 mint.
• While a mint is paused, the token program rejects transfers, mints and burns. Nothing else about the token changes.
• It is reversible. Resume is a single instruction from the same authority, and the mint goes straight back to normal.
• It works at the mint level, unlike freeze authority, which works one account at a time.
• The pause authority is separate from the mint, freeze and update authorities. It can be kept, assigned elsewhere, or revoked.
• The extension can only be enabled when the mint is created. There is no way to bolt it onto a token that already exists.

What Is the Pausable Token Extension?

The pausable extension is a Token-2022 mint extension that stores two things on the mint account: who the pause authority is, and whether the mint is currently paused. Solana's pausable tokens documentation puts it plainly — the extension "gives a pause authority the ability to pause and resume token activity for the entire mint."

That is the whole feature. A 32-byte address and a single true-or-false flag, read by the token program on every instruction that touches the token.

Like the rest of the token extensions, it runs at the protocol level. There is no custom program to deploy, no admin contract to audit, and no bot watching for trouble. The enforcement is the token program itself.

What Happens When a Token Is Paused?

Three things stop, and the documentation is specific about which three: "When a mint is paused, the Token Extension Program rejects: Transfers, Mints, Burns."

A few consequences follow from that list:

• Everyone is affected at once. There is no per-wallet targeting. The creator's wallet is as frozen as everyone else's.
• Trading stops. A decentralized exchange pool moves tokens by transferring them, so a paused mint means no swaps.
• Supply is locked in both directions. Nobody can mint new tokens and nobody can burn existing ones.
• Balances are untouched. Every account keeps exactly what it had. Paused is not the same as gone.

And the part people miss: it is reversible. Pause and Resume are two instructions flipping the same flag. The authority can send Resume seconds or months later and the mint picks up where it left off.

Pausable vs Freeze Authority: What's the Difference?

These two get confused constantly, because both stop tokens from moving. The difference is scope.

• Freeze authority is part of the original SPL Token program and works one token account at a time. You freeze a specific wallet's holding of your token. Everyone else carries on as normal. Revoking freeze authority is a common trust signal for exactly that reason.
• The pausable extension is Token-2022 only and works at the mint level. One transaction stops every holder simultaneously, and one transaction starts them again.

The more useful distinction is what survives. A pause ends the moment the authority resumes the mint, and everyone is trading again in the same block. A freeze does not — an account frozen before a pause is still frozen after the resume, because the two are entirely separate switches on entirely separate things.

There is a third thing worth separating out: non-transferable (soulbound) tokens, which can never move at all. Pausable is temporary by design. Non-transferable is permanent by design. If you want tokens to stay put forever, pausable is the wrong tool.

Who Can Pause a Token?

Only the address recorded as the pause authority on the mint. It is its own permission, deliberately kept apart from the others — the pause authority cannot mint, cannot freeze an account, and cannot change metadata. Holding one of those authorities does not grant this one.

You have the usual three choices at mint time:

• Keep it on your own wallet, if you want to be able to act quickly.
• Assign it to a multisig, a DAO treasury, or a program address so pausing needs more than one person's signature.
• Revoke it at creation, which means the extension is present but the token can never be paused by anyone.

The middle option deserves real thought. A pause is a powerful and very visible action, and holders are a lot more comfortable when no single key can trigger one.

When Is a Pausable Token Actually Useful?

The extension earns its place where the ability to stop everything is a genuine safety feature rather than a control preference:

• Incident response. An exploit in a related contract, a compromised authority key, or a bridge going wrong. Pausing buys time to assess before the damage spreads.
• Staged launches. Mint and distribute a supply with the token paused, verify everything is where it should be, then resume to open trading at a specific moment.
• Regulated or custodial designs. Stablecoins and tokenized instruments often need a documented way to halt activity, and a protocol-level pause is cleaner than a bespoke contract doing the same job.
• Migrations. Holding a token still while balances are snapshotted and moved somewhere else.

What it is not good for is routine control. If the answer to every problem is pausing the token, holders will notice, and the extension will do more reputational damage than the problems it solves.

The Trade-Off Holders Will Weigh

Be honest with yourself about this one: one address being able to stop all movement of a token is centralization, whatever the intent behind it. A holder who cannot sell during a pause is not comforted by the reason for it.

Three things tend to blunt that concern:

• Put the authority somewhere accountable. A multisig or governance address makes a pause a decision rather than an impulse.
• Say up front what would trigger one. A written policy turns an alarming capability into a predictable one.
• Revoke it when the token is mature. A pause authority that existed through launch and was then given up is a much better story than one that quietly persists.

Worth knowing too: the pause authority and the paused flag both sit in the mint account, so anyone reading the mint can see them. The capability is public information from the moment you sign, and so is every use of it.

How Do You Create a Pausable Token Without Code?

The extension has to be initialized after the mint account is created but before InitializeMint, and all of it has to land in one transaction. That ordering requirement is the entire reason it cannot be added later, and it is the same constraint that governs the rest of the Token-2022 extension set.

Pausable is a Token-2022 feature, so it sits on the Pro tier of our builder. You toggle it on in the Extensions step, choose whether the pause authority stays with you, goes to another address, or is revoked, and sign. The builder assembles the three instructions in the correct order for you.

If you are still choosing a tier, the token creator lays out the differences. The short version is the same as it is for transfer fees and interest-bearing balances: extensions are a mint-time decision, so work out which ones you need before you sign anything.

How Do You Pause or Resume a Token?

Pausing is one instruction sent to the mint and signed by the pause authority. Resume is the same thing with the flag going the other way. Neither touches a single token account.

On our manage-token page, load the mint address with the pause authority wallet connected. The page reads the current state straight off the chain and shows the token as active or paused, along with which address holds the authority. One button, one signature, and the mint changes state.

If a different wallet is connected, you still see the status and the authority — you just cannot act on it. That is worth knowing in the other direction too: anyone can check whether a token they hold is pausable, and who can pause it, before they buy.

Disclaimer

This guide is for educational purposes only and is not financial, legal, or investment advice. SoulMinter is an independent software tool and is not affiliated with, endorsed by, sponsored by, or partnered with the Solana Foundation, Solana Labs, or any other third party mentioned or linked in this article. External links are provided for reference only; we do not control their content. All product names, trademarks, and brands are the property of their respective owners and are used for identification purposes only. Always do your own research and use any third-party service at your own risk.