🧾Custom JSON

Custom JSON is an optional feature for advanced users who wish to add traits to their NFTs.

🚀 Custom Metadata Quick Start

1️⃣ Prepare Your Files

You need TWO sets of files:

• Images: 1.png, 2.png, 3.png... (your NFT artwork)

• JSON: 1.json, 2.json, 3.json... (your metadata)

Important: The numbers must match! First JSON goes with first image.

2️⃣ JSON Structure (Minimum Required)

{
  "name": "Your NFT Name #1",
  "description": "Your NFT description",
  "image": ""
}

That's it! Toast will handle the image URL automatically.

3️⃣ Adding Traits (Optional)

Want traits? Add an attributes array:

{
  "name": "Toast Warrior #1",
  "description": "A brave warrior",
  "image": "",
  "attributes": [
    {
      "trait_type": "Class",
      "value": "Warrior"
    },
    {
      "trait_type": "Level",
      "value": "50"
    }
  ]
}

4️⃣ Upload Process

1. Go to the Create page

2. Upload your images first

3. Toggle "Use Custom Metadata" to ON

4. Upload your JSON files

5. Launch! 🚀

✅ Checklist

• Same number of images and JSON files

• Files numbered correctly (1, 2, 3...)

• Each JSON has name and description

• Leave image field empty or with placeholder

• Valid JSON format (check with JSONLint)

🆘 Common Fixes

Error: "Number of images and metadata files must match"

→ Count your files. You need exactly the same amount.

Error: Invalid JSON

→ Missing comma, quote, or bracket. Use JSONLint to validate.

Traits not showing on marketplaces

→ Use attributes array with trait_type and value keys.

JSON uploader not accepting collection metadata.

→ Use the UI for all collection metadata, only upload JSONs for your actual assets.

💡 Pro Tip

Start with 3-5 NFTs as a test. Once it works, scale up to your full collection!

---

Reach out via our telegram for additional guidance.