NMKR Docs
ProductsContact
English
English
  • Welcome to NMKR Docs
  • Introduction
    • About NMKR
    • Powered by NMKR
    • What is an NFT?
      • What is IPFS?
    • Why Cardano?
  • NMKR Studio
    • Introduction - NMKR Studio
    • Features Overview
    • 🖥️Learn NMKR Studio in 3 minutes
      • Basic Workflow
    • How to - Quick Start Tutorials
      • Quickstart Full Video Tutorial
      • Guidelines Planning a Project
      • How To Add Tokens
      • How to set up Metadata
      • How To Sell Tokens
      • How To Set Up Sales Conditions
      • How To Do a Reveal
      • How To Burn Tokens
      • How To Enable Royalties
      • How To Enable DIDs
      • How To Set up Whitelisting
      • How to Airdrop Tokens
    • Pricing
    • Account
      • Registration & KYC
      • Security
      • Wallets
      • Mint Coupons
      • Dashboard
      • Transactions
      • Invoices
      • API Keys
    • Project
      • Policy
        • Managing policies
      • Create
      • Edit
      • Metadata Template
      • Statistics
      • DID - Decentralized Identifier
      • Notifications
      • Royalties
      • Additional Payout Wallets
      • Affiliate links
      • Export Metadata as Zip
      • Export NFT as csv
      • Mint and Send Jobs
      • Export placeholder.csv
    • Token
      • Manage Tokens Tab
      • Upload
        • Upload single tokens
        • Bulk Upload Files and Metadata
          • Bulk Upload via Drag and Drop
          • Bulk upload via SFTP
      • Edit
      • Metadata
        • Add Token-specific Metadata
        • Fingerprint (Metadata preview)
        • Metadata Check
        • Metadata Standard for fungible Tokens
        • Fully on-Chain NFTs
          • Partial URL-Encoding
        • CIP-68
      • Duplicate
      • Delete
      • Burn
      • Update (Edit after Mint / Reveal)
    • Set up Sales
      • Manage prices / Pricelist
        • Create new Prices
        • Free Drops
        • Custom Token payment
        • Discounts
      • Sales Conditions & Whitelisting
        • Sales conditions depending on policy ID or stake pool
        • Whitelist with Count
        • Blacklist
        • Test Sales Condition
      • Block Tokens
      • NMKR Pay
        • Set up NMKR Pay
        • MultiSig Payment
        • Website Integration
        • Specific Payment Links
        • Manual sending in NMKR Pay
        • FIAT ETH and SOL Payment
      • Pay-In Address
      • Auction
    • Minting
      • Minting on Demand
      • Manual Minting
      • Airdropper
        • Airdrop with random distribution
        • Airdrop with specific distribution
    • Tools
      • Managed Wallets
      • Split Addresses
      • Direct Sales
      • Policy Snapshot
      • Integrations & Plugins
        • NFT Pal
        • Zapier
    • Testnet
      • Create Testnet Account
      • Testnet Wallet & tADA
      • Testnet API Swagger
  • NMKR Studio API
    • Introduction - NMKR Studio API
    • API Features
    • Swagger API Endpoints
    • Get started with the API
    • API Swagger
      • Get Started with the Swagger
      • Swagger Responses and Error Codes
    • API Examples
      • Users
        • Payout Wallets
        • Subcustomers
      • Project
        • Create Project
        • Upload File and Metadata
      • Payment
        • Create unique NMKR Pay Link for random Token sales
        • Create NMKR Pay Link for specific Token sales
        • Get Payment Address for single NFT sales with native Tokens
        • Create NMKR Pay Link for a multi-specific Tokens sale
      • Minting
        • Manual Minting
      • Smart Contract
        • Secondary Sales via NMKR Pay
    • API Open Source Contributions
  • NMKR Mint
    • Introduction - NMKR Mint
    • Mint single NFTs
    • Mint Collection
  • NMKR Playground
    • Introduction - NMKR Playground
    • ADA Payment Link
    • Paperwallet
  • NMKR Pool
    • What is Staking?
    • Stake with NMKR Pool
  • Helpful Links
    • Cardano NFT Ressources
    • Cardano Resources
    • Cardano Wallets
    • Open Source Repositories
    • Security Practices
    • Deal with Bots
Powered by GitBook
On this page
  • Option 1: Add custom metadata fields in the user interface
  • Option 2: Upload metadata in a placeholder.csv sheet
  • Option 3: Upload metadata as JSON file
  1. NMKR Studio
  2. Token
  3. Metadata

Add Token-specific Metadata

Here we will explain different methods to add metadata to your tokens

PreviousMetadataNextFingerprint (Metadata preview)

After to your project, you want to add metadata that is unique for every single token, like custom traits etc. In NMKR Studio, we have different workarounds to accomplish that.

Option 1: Add custom metadata fields in the user interface

Option 2: Upload metadata in a placeholder.csv sheet

Specify the fields you want to add in the metadata template

Download the placeholder.csv template of your project

Edit the placeholder.csv in the spreadsheet software.

Save the new placeholder.csv file

Upload the placeholder.csv to your project

Please make sure that the placeholder.csv is always the last file that is uploaded to the project or it won't apply correctly for all tokens of the project. If you add tokens or subfiles afterwards, please make sure to upload the placeholder.csv again afterwards and after deleting the old placeholder.csv file from the server.

Option 3: Upload metadata as JSON file

Separate into single .json files and make it Cardano compliant

Rename the .json to .metadata or .metadatacip68

Helpful resources for users of hashlips

If you used Hashlips to create your images and metadata, this following video can be very helpful to split your json and make it fitting for Cardano.

You can add metadata values to the NFT in the edit section of the token using the user interface. Each that was can then be specified by in the placeholder data tab in the . This is the easiest way to add custom metadata fields to your tokens, but it is also not suitable to add metadata for a higher number of tokens.

If you want to add not only custom fields and values to your token but a complete metadata code to your token, please use the .

This is probably the easiest way to upload metadata to your tokens in bulk. This method allows you to upload a sheet that contains values for each token and each that was previously specified in the by simply adding them with a spreadsheet-software like Excel or Google sheets.

The first step to use this method is to . Each field will later be a column in your spreadsheet.

The next step is to template of your project, which will contain all the fields of your project's specified metadata template.

Open the placeholder.csv in a spreadsheet-software like excel of google sheets. The placeholder.csv template already contains all the and tokens that were uploaded to the project. You can now easily add all the custom values to the spreadsheet.

After you specified all the metadata in the spreadsheet you want to save the file named as "placeholder.csv". Please make sure that you export the file again as CSV with comma separated values. It can happen that users of the German version of Excel may have this file exported with semicolon separated values. This won't work. Please copy the spreadsheet to a new sheet created in and export it there.

The final step is to upload the edited placeholder.csv to your project. In order to do that, please use the or .

You can also use the to add JSON files to your project. Many projects have their image files exported together with a .json file that contains all the metadata that belongs to each token. You will need to split them into single .json files for each individual token, if you used . Please make sure that your JSON is in the and it contains all the values you specified as .

Before you upload the JSON via drag and drop to the project folder on the you have to rename them from ".json" to ".metadata" or ".metadatacip68" if you are using . This can be easily done with bulk renamer tools, there are plenty of it and the most are free versions. The newly renamed ".metadata" can only match and add metadata to the token, if it is named correctly. If your tokens is "0001" you want to rename the belonging "file.json" to "0001.metadata". The metadata can only be added after the token was uploaded.

custom field
previously specified in the metadata template
edit section of your token
metadata override
field
metadata template
add all the custom fields you need in the metadata template
download the placeholder.csv
fields that were added to the metadata template
google sheets
SFTP upload
bulk upload
SFTP bulk upload
hashlips for the creation of the images and metadata you need to split it and make it fit for Cardano
correct format (CIP-0025)
placeholders in your metadata template
SFTP server
CIP-68
asset_name/tokenname
uploading all tokens
Placeholder data tab in the edit section of your token
If you were using an older version of NMKR Studio, please note that we changed the heading of the first column from file_name to asset_name.