Store Listing Fields
When you register an app, you provide metadata that appears in the app store:| Field | Required | Description |
|---|---|---|
| Name | Yes | Display name for your app |
| Description | Yes | Short summary shown on the store card |
| Logo | Yes | Square image for the app icon |
| Category | Yes | Focus, Gaming, Wellness, or Research |
| Website | No | External link to your app |
| Social links | No | Twitter, Discord, GitHub, etc. |
| Team members | No | Public team display |
NFT Metadata Standard
App tokens and in-app items follow ERC-721 with ERC-4906 metadata update signaling. This means metadata changes emit on-chain events that marketplaces can listen to for auto-refresh. Example metadata JSON:Image Requirements
| Asset | Recommended Size | Format |
|---|---|---|
| App logo | 500x500px | PNG or SVG |
| Token image | 1000x1000px | PNG |
| Store banner | 1200x630px | PNG or WebP |
Storage Options
| Option | Best For | Notes |
|---|---|---|
| IPFS (Pinata, NFT.Storage) | Production | Recommended. Decentralized and permanent. |
| Arweave | Production | Alternative permanent storage. |
| Centralized HTTP | Development | Fine for testing. Do not use for production tokens. |
Once metadata is referenced on-chain, changing the underlying content at the same URI does not trigger an ERC-4906 update. Use
setTokenURI to point to new content and emit the update event.Updating Metadata
After launch, your Safe can update app metadata by calling the appropriate registry function. Token metadata updates follow the ERC-4906 pattern: set a new URI and emit theMetadataUpdate event so marketplaces and indexers refresh.
Next
Launch Your App
Deploy your app on-chain
Post-Launch Checklist
What to do after launch
Items and Unlocks
Create in-app items