> For the complete documentation index, see [llms.txt](https://docs.guild.xyz/guild/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guild.xyz/guild/how-to-setup-rewards/nft-reward.md).

# NFT reward

Create and distribute custom NFTs to role members. Perfect for proof-of-participation, collectibles, community credentials, or exclusive access tokens with real onchain utility.

#### Setting up NFT rewards

**1. Create the NFT**

* In the role editor, click **"Add reward"** and select **NFT**
* Upload NFT image (JPG, PNG, or GIF, up to 100MB)
* Add NFT name and metadata description (optional)
* Set metadata attributes (rarity, level, season, etc.) - optional
* Choose transferability: **Non-transferable (Soulbound)** or **Transferable**<br>

**2. Configure supply and claiming**

* Set supply: **Unlimited** or **Limited** with a maximum number
* Set claim limits per wallet address
* Configure claiming time window (start and end dates)
* Choose supported blockchain from dropdown<br>

**3. Set pricing and payout**

* Set mint price or leave it zero for free minting
* Configure payout address (defaults to your connected wallet)
* Note: small Guild minting fee applies<br>

**4. Deploy NFT**

* Click **"Create NFT reward"** to deploy the contract onchain
* Only members who meet the role's requirements can claim the NFT
* Click **"Collect NFT"** to see contract details and top collectors

{% hint style="info" %}
Each NFT can only be attached to a single role.
{% endhint %}

#### How NFT rewards work for members

* Members see the NFT reward but cannot claim until they meet role requirements
* Once qualified, members click **"Collect NFT"** to mint the NFT to their wallet
* Minting happens onchain and requires gas fees
* NFTs appear in member wallets and automatically list on OpenSea
* Metadata updates dynamically reflect on already minted NFTs

Unlike other rewards, members keep their NFTs permanently even if they lose role access, since the NFT is already minted onchain.

<figure><img src="/files/hn1bt61DIesWTmQmRBeP" alt=""><figcaption><p>Collect NFT page</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.guild.xyz/guild/how-to-setup-rewards/nft-reward.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.