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 uploading all tokens 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

You can add metadata values to the NFT in the edit section of the token using the user interface. Each custom field that was previously specified in the metadata template can then be specified by in the placeholder data tab in the edit section of your token. 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 metadata override.

Option 2: Upload metadata in a placeholder.csv sheet

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 field that was previously specified in the metadata template by simply adding them with a spreadsheet-software like Excel or Google sheets.

Specify the fields you want to add in the metadata template

The first step to use this method is to add all the custom fields you need in the metadata template. Each field will later be a column in your spreadsheet.

Download the placeholder.csv template of your project

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

Edit the placeholder.csv in the spreadsheet software.

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

Save the new placeholder.csv file

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 google sheets and export it there.

Upload the placeholder.csv to your project

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

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

You can also use the SFTP bulk upload 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 hashlips for the creation of the images and metadata you need to split it and make it fit for Cardano. Please make sure that your JSON is in the correct format (CIP-0025) and it contains all the values you specified as placeholders in your metadata template.

Rename the .json to .metadata or .metadatacip68

Before you upload the JSON via drag and drop to the project folder on the SFTP server you have to rename them from ".json" to ".metadata" or ".metadatacip68" if you are using CIP-68. 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 asset_name/tokenname is "0001" you want to rename the belonging "file.json" to "0001.metadata". The metadata can only be added after the token was uploaded.

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.

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.