Loopring Pro
  • Loopring Pro
  • Connect to Loopring L2
  • Mint NFT in 1-2-3
  • đź’°Assets and Markets
    • Assets Page
      • Transaction History
    • How to:
      • Make instant transfers on Loopring
      • Withdraw from L2 to L1
      • "Force Withdraw" my tokens to L1
      • Receive Red Packets without a camera
    • Markets Page
  • 🔄Trade
    • Swap Assets
      • Swap tokens gas-free
      • Trade on the order books
  • đź’¸Earn
    • Overview
      • AMM Pool
        • Finding the highest earning pools on Loopring
        • Add liquidity to an L2 AMM pool
        • Remove liquidity from an AMM pool
      • ETH Staking
        • Leveraged ETH Staking
      • Dual Investment
        • Beginner Mode
      • LRC Staking
  • 🎨NFT
    • My NFTs
    • Create Collection
    • Create NFT
      • Easy Minting
      • Advanced Minting
        • Method A
        • Method B
        • Method C
    • Advanced
      • Import Legacy NFT
      • Support NFT collections minted in both Ethereum Layer 1 and Loopring Layer 2
      • Loopring Layer 2 Mint Metadata Explanation
      • Collection Implementation in Loopring Layer 2
      • Loopring NFT Platform Implementation Guide
  • 🌟Other Features
    • VIP Tiers
    • Guardian Actions
    • Bridge
    • Taxes: Koinly
      • Guide
    • Change Logs
      • 2025
        • May 22
        • May 19
        • May 15
        • Mar 3
        • Feb 25
        • Jan 15
      • 2024
        • 20 Nov
        • 22 Oct
        • 10 Oct
        • 24 Sep
        • 7 Sep
        • 30 Aug
        • 28 Aug
        • 3 Jul
        • 16 May
        • 17 Apr
        • 11 Apr
        • 9 Apr
        • 1 Apr
        • 27 Mar
        • 21 Mar
        • 1 Mar
        • 4 Feb
        • 19 Jan
        • 2 Jan
      • 2023
        • 20 Dec
        • 1 Dec
        • 29 Nov
        • 28 Nov
        • 24 Nov
        • 20 Nov
        • 9 Nov
        • 31 Oct
        • 13 Oct
        • 12 Oct
        • 10 Oct
        • 27 Sep
        • 24 Aug
        • 14 Aug
        • 09 Aug
        • 02 Aug
        • 18 Jul
        • 17 Jul
  • 📺Video Guides
    • Connect Metamask and activate Loopring L2
    • Deposit from Ethereum L1 (MetaMask) to Loopring L2
    • Use Metamask to Transfer to other Loopring L2 users
    • Withdraw from Loopring L2 back to Ethereum L1 using MetaMask
    • Trade on the Loopring L2 DEX
    • Provide liquidity on Loopring L2
Powered by GitBook
On this page
  • A. Minimum requirements when minting
  • B. A note about "image" and "animation_url"
  • C. Royalties
  • D. Example with Traits
  • E. “mint_channel”

Was this helpful?

  1. NFT
  2. Advanced

Loopring Layer 2 Mint Metadata Explanation

PreviousSupport NFT collections minted in both Ethereum Layer 1 and Loopring Layer 2NextCollection Implementation in Loopring Layer 2

Last updated 1 year ago

Was this helpful?

Loopring supports metadata according to the ERC1155 metadata schema format which uses the “properties” array. For more information regarding the overall spec as well as the syntax of this format, please visit: . Loopring also supports OpenSea’s metadata schema format which uses the “attributes” array. For more information regarding the syntax of this format, please visit: .

A. Minimum requirements when minting

{
    "name": "NFT Name",
    "description": "Description of your collection.",
    "image": "ipfs://CID-TO-SMALL-THUMBNAIL",
    "animation_url": "ipfs://CID-TO-FULL-SIZE-IMAGE-OR-VID",
    "royalty_percentage": 0,
    "collection_metadata": "ipfs://Qm7Ys...usd",
    "mint_channel":  "Loopring"
}

B. A note about "image" and "animation_url"

In general, the "image" field is intended to be a smaller, faster loading thumbnail of your content, while the "animation_url" is intended to be the full-size image, video, or other file type of your NFT. It's okay to set both fields to the same value, several NFTs have done it this way.

  1. “image”

    • The "image" field in the metadata should always be an image file type (png, jpg, gif, etc.). Marketplaces consider it to be a lower quality thumbnail to help. ensure the thumbnail of your content loads quickly.

  2. “animation_url”

    • The “animation_url” field is reserved for a high quality picture, GIF, video or audio file. When using this field you should enter a thumbnail version into the “image”  field and the higher quality file into the  “animation url” field. Marketplaces will automatically display the correct file, even HTML, if it is in the  “animation_url” field.

C. Royalties

The “royalty_percentage” field is an integer. It can be any value between 0 - 10. When trading in Loopring L2, the royalty will be collected and automatically distributed to the creator via the Loopring relayer.

D. Example with Traits

Including traits in the metadata allows the creator to indicate a level of rarity for the NFT. Additionally, marketplaces may use them to enable users to search or filter when looking for an NFT. As previously mentioned, Loopring includes both the "properties" and  "attributes" arrays when minting. While the syntax is slightly different between the two, both arrays contain identical information and allow the creator to set customized traits for any given NFT.

 {
    "name": "NFT Name",
    "description": "Description of your NFT",
    "image": "ipfs://CID-TO-THUMBNAIL-SIZE",
    "animation_url": "ipfs://CID-TO-FULL-SIZE-OR-FILE",
    "royalty_percentage": 0,
    "attributes": [{
        "trait_type": "Hair",
        "value": "Curly"
    }, {
        "trait_type": "Nose",
        "value": "Massive"
    }, {
        "trait_type": "Mouth",
        "value": "Closed"
    }, {
        "trait_type": "Chin",
        "value": "Beard"
    }],
    "properties": {
        "Hair": "Curly",
        "Nose": "Massive",
        "Mouth": "Closed",
        "Chin": "Beard"
    }
}

Example with Collection Metadata

{
    "contract": "0x9e1…f0b",
    "banner_uri": "ipfs://Qm8I9...8de",
    "avatar_uri": "ipfs://Qm8I9...8de",
    "tile_uri": "ipfs://Qm8I9...8de",
    "name": "Test NFTs", 
    "description": "NFTs for platform testing." 
}

The contract field should match the contract address that the NFT exists within.

Below is the description for collection metadata:

  1. Avatar: 500*500 pixel

    • Your collection can have its own avatar, separate from your profile avatar or icon. Collection avatars can be static images or gif/webp files. 

  2. Banner: 1500*500 pixel

    • The collection banner sits at the top of your collection page. Collection banners can only be static images. 

  3. Tile: 500*700 pixel

    • Also referred to as the cover. Your collection tile displays on your profile and the explore page as a static image or gif/webp animation.

If the URI points to an IPFS address, the collection is immutable; if the URI points to an HTTPS address, the collection is mutable. For more information, please refer to the collection-relevant document.

E. “mint_channel”

The “mint_channel” is an optional field. It specifies the channel from which the NFT is minted if it exists. For example, “Loopring” indicates the creator is minting the NFT from the Loopring mobile app (or web); “Uptick” indicates the creator is minting the NFT from the Uptick marketplace.

More info from the OpenSea standard:

🎨
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1155.md#erc-1155-metadata-uri-json-schema
https://docs.opensea.io/docs/metadata-standards#attributes
https://docs.opensea.io/docs/metadata-standards#metadata-structure