Mintable Help
  • Welcome to Mintable
  • NFT Basics
    • What is ETH/Ethereum?
      • What is an Ethereum Wallet - how do I get one?
      • How do I get ETH?
      • Why is Ethereum Gas Fees so High?
      • How do I speed up or cancel a pending transaction on Ethereum?
      • Gasless Minting
    • What are NFTs (digital items)?
  • THE ECOSYSTEM
    • The Mintable Ecosystem
    • Should I mint on Mintable or Mintology?
  • USING MINTABLE
    • Get Started
    • NFT Wallets
      • What Crypto Wallets are supported by Mintable?
      • Mintable Custodial Wallet
        • Frozen Mintable Custodial Wallet!
        • Claiming Mintable Custodial wallet
      • Connecting more wallets
      • Linking your Metamask - Mobile Version
      • Removing wallets
      • NFT Tags
    • Your Profile
      • Edit my profile/Account settings
    • Searching on Mintable
      • What is a "Guaranteed Authentic" collection?
      • Search with AI
      • Marketing Assets for Project Owners
    • Buying and Selling NFTs
      • How to Sell Items that are already in Your Wallet
  • For Creators
    • Creating NFTs
      • How to create an item
        • What files can I upload and what is the size restrictions?
      • How to edit your listing price
      • How to cancel your listing
      • Certifying your rights
    • Collections
      • Creating a Collection
      • Minting to Collection
      • Manage Collections
      • Listing from Collection
      • Customise Collection Page
  • Claimable NFTs
    • What is a Claimable NFT?
  • How to Create a Claimable NFT collection?
  • FAQs
    • Why buy these NFTs? / What makes them valuable?
    • How do I know what I'm buying is legit and not a fake?
    • How to sell digital items?
    • How to view my NFTs in MetaMask?
    • How to Transfer NFTs on Mintable?
    • How do I delete or burn my NFTs?
    • How do I find the contract address for my NFTs?
    • Help!
      • My account is disabled.
      • I have received a verification code email to create a Mintable account that I did not request.
      • Advanced - Custom Server for Metadata
      • User Safety Guide: Staying Safe on Mintable and in the Metaverse
    • Digital Millennium Copyright Act or “DMCA”
    • I would love to work with Mintable!
    • Immutable X
      • What is Immutable X?
Powered by GitBook
On this page

Was this helpful?

  1. FAQs
  2. Help!

Advanced - Custom Server for Metadata

Hosting the metadata on your own server

PreviousI have received a verification code email to create a Mintable account that I did not request.NextUser Safety Guide: Staying Safe on Mintable and in the Metaverse

Last updated 9 months ago

Was this helpful?

This option is advanced and requires you to host the metadata on your own website/server using a specific URL.

When creating your store, you have the option to host the metadata on your own servers.

You might want to do this because:

  • You want to change the metadata periodically

  • Your project requires the metadata to be changeable

  • You want to control your data

  • You want to host your metadata on another platform outside of Mintable

Requirements

URL structure

The BaseURI is stored on the contract and every token uses it for the URL

Each token has a unique ID - such as token 1, token 2, token 3.

Each token will return a URL for the individual metadata of that token - so when you want the URL for token 3 - it will return: baseURI + token ID

If your baseURI is https://mywebsite.com/metadata/ then token 3 will return:

https://mywebsite.com/metadata/3

This is important to note: your baseURI must have a "/" at the end

good: "https://mywebsite.com/metadata/"

bad (won't work): "https://mywebsite.com/metadata"

Hosting the data

Once you have set up the baseURI, you will need to host the data on your server according to that baseURI. So if you set your URL as above "https://mywebsite.com/metadata/" and you make the first 5 tokens, tokens 1 - 5, you will need to host the metadata for each token at:

URL

TokenID

https://mywebsite.com/metadata/1

1

https://mywebsite.com/metadata/2

2

https://mywebsite.com/metadata/3

3

https://mywebsite.com/metadata/4

4

https://mywebsite.com/metadata/5

5

Creating the items

When you create a new item and list it for sale on the site - you will be shown the popup below. This will provide you the metadata you need to host on your server, in the format it should be hosted in.

You can change the "image:" field or any other field you'd like to change/add - but if you do - make sure you follow the NFT metadata standard

If you do not host this data at the https://baseURI/tokenID that you set - your token will not be displayed properly.

Tokens not displaying properly

To debug the situation - go to etherscan.io and look up your contract's address.

Go to the "read" tab on Etherscan for your contract so you can read the smart contract.

Type in the token ID for the field "tokenURI()" on Etherscan.

This is where your metadata needs to be located

The URL returned here is where the metadata for this token needs to be hosted. If your URL is incorrect, or you have another issue and cannot host your metadata here - then you won't be able to see/display this token.

The baseURI you set must be correct.