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

# NFT Credentials

> Mint each credential of a group as an NFT on Hedera, so recipients can keep it in their own crypto wallet.

NFT credentials is a credential group setting. When it is on, every credential you publish in the group is also minted as an NFT (a non-fungible token) on Hedera, a public blockchain. Hyperstack keeps the NFT safe until the recipient claims it to their own wallet, such as HashPack or MetaMask.

The credential itself does not change. Recipients still get the same email, credential page and wallet. The NFT is an extra, public proof that they hold the credential.

> [!NOTE]
>
> NFT credentials is an add-on. [Contact us](mailto:hello@thehyperstack.com) to turn it on for your organization. You need the **Credential issuer** or **Administrator** role to change a group.

## Turn on NFT credentials

**1. Open the group**

Go to **Credential Groups** and click the group. For a new group, click **Create group**.

**2. Open the Security settings**

Under **More settings**, click **Security**.

**3. Set NFT credentials to Enabled**

The row then reads **NFT credentials on**.

**4. Save the group**

Click **Update group**, or **Create group** for a new group.

![The Security settings of a credential group with NFT credentials enabled](https://mintcdn.com/hyperstack/AaOEcWNGBPdoC5zh/images/nft-group-switch.webp?fit=max\&auto=format\&n=AaOEcWNGBPdoC5zh\&q=85\&s=b789193c0cc4568aa9baacc578590d7b)

New groups start with it disabled. To turn it off, set **NFT credentials** to **Disabled** and save the group.

## What happens when you publish

1. You publish credentials as usual. Publishing is as fast as before: it does not wait for the NFTs.
2. In the background, Hyperstack mints one NFT for each credential. A single credential is usually minted in under a minute. A large group takes longer, for example about an hour for 10,000 credentials.
3. Each NFT stays in the Hyperstack vault until its recipient claims it.

If Hedera does not answer, Hyperstack tries again on its own. A failed mint never stops a credential from being published.

Your organization gets its own NFT collection on Hedera, named after your organization. It is made the first time you mint.

### What goes on the blockchain

Only the link to the public credential page goes into the NFT. Names, email addresses, titles and other credential data do not. The credential page shows the design and the details, as it does today.

### Existing credentials

Only credentials that you publish after you turn on the setting get an NFT. Credentials that you published before do not.

## How recipients claim the NFT

The recipient signs in to their [wallet](https://thehyperstack.com/docs/tutorials/recipients/wallet.md). The credential card reads **NFT ready to claim**.

![Two credential cards in the wallet: one with the NFT in the recipient's wallet, one with the NFT ready to claim](https://mintcdn.com/hyperstack/AaOEcWNGBPdoC5zh/images/nft-wallet-cards.webp?fit=max\&auto=format\&n=AaOEcWNGBPdoC5zh\&q=85\&s=1c509541e8296ca5715ac0d641fb417f)

They open the claim form, paste their wallet address and click **Claim NFT**:

* A Hedera account ID, for example `0.0.4455667` (HashPack and other Hedera wallets).
* An EVM address that starts with `0x` (MetaMask and other Ethereum-style wallets).

![The Claim your NFT dialog with a Hedera account ID in the Wallet address field](https://mintcdn.com/hyperstack/AaOEcWNGBPdoC5zh/images/nft-wallet-claim.webp?fit=max\&auto=format\&n=AaOEcWNGBPdoC5zh\&q=85\&s=cf383a46be093523553fc8a375041845)

The NFT reaches the wallet within seconds. Some wallets ask the recipient to accept a new NFT before it shows.

* Each credential's NFT can be claimed **once**.
* Only the recipient of the credential can claim it.
* The NFT **cannot be sent on** to another wallet. It stays with the recipient, like the credential.

## What verifiers see

On the credential page, the **Credential Authenticity** section shows two more rows:

* **NFT**: the collection ID and the NFT number, for example `0.0.5129874 · #18`. Click it to open the NFT on HashScan, a public Hedera explorer.
* **NFT status**: **In the Hyperstack vault** before the recipient claims it, then **Claimed**.

![The Credential Authenticity section with the NFT and NFT status rows, status Claimed](https://mintcdn.com/hyperstack/AaOEcWNGBPdoC5zh/images/nft-credential-claimed.webp?fit=max\&auto=format\&n=AaOEcWNGBPdoC5zh\&q=85\&s=2775bccd0dc6755bb70948265634f48a)

The credential page never shows the recipient's wallet address.

When the recipient views their own credential, the page also shows **Claim it to your wallet** while the NFT is in the vault.

![The credential page for the recipient, with the NFT in the Hyperstack vault and a Claim it to your wallet link](https://mintcdn.com/hyperstack/AaOEcWNGBPdoC5zh/images/nft-credential-vault.webp?fit=max\&auto=format\&n=AaOEcWNGBPdoC5zh\&q=85\&s=2036f711e0fa08708fbac9b4c0124349)

## When you revoke or delete a credential

Hyperstack removes the NFT from the blockchain:

* If the recipient has not claimed it, the NFT is burned.
* If the recipient has claimed it, the NFT is taken back from their wallet and removed.

When you suspend a credential, the NFT stays. The credential page shows that the credential is suspended.

## If the add-on ends

* Hyperstack stops minting new NFTs at once.
* NFTs that already exist stay. Recipients can still claim them, and they are still removed if you revoke the credential.
* The **NFT credentials** setting is hidden from the group form.

## Technical details

* **Network**: Hedera mainnet, using the Hedera Token Service (HTS).
* **Collection**: one non-fungible token per organization. Hyperstack holds the supply, freeze and wipe keys.
* **NFT metadata**: the URL of the public credential page.
* **Non-transferable**: after the NFT reaches the recipient's account, Hyperstack freezes that account for the collection, so the NFT cannot be sent on.
* **Delivery**: a Hedera token airdrop. If the wallet has no free slot for a new token, the airdrop waits until the recipient accepts it in the wallet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.