Create CSV File

To successfully perform a Bulk Upload in Buildtree, you need a correctly formatted CSV file that pairs with your uploaded folder.

This CSV file provides essential metadata for each asset, such as titles, descriptions, attributes, and more. Follow this guide to create your CSV file properly and ensure a smooth upload process.

Steps to Create a CSV File

  1. Use Our CSV Template Buildtree provides you with a sample CSV template for the collection metadata. So, you just need to fill the file with your project information. This template includes all the necessary fields, such as:

    • Token ID

    • Name

    • Description

    • Attributes

  • Green: Mandatory

  • Orange: Optional

You need to replace the dummy text on the document with your project information. Each row represents an asset in your folder. The TokenID column should match the file names in your asset folder exactly.

Find here the Example Template 📂

  1. Fill Out the Metadata

  • Name: Provide a name for each asset.

  • Description: Add a brief description for each asset.

  • Attributes: If your project includes attributes, fill them out in the designated columns (e.g., Color, Rarity, etc.). These attributes will define specific traits or properties for each asset.

Example:

tokenId
name
description
color
rarity

0

Golden Horizon

A stunning sunset shot

Gold

Rare

1

Midnight Dreamer

A serene night scene

Blue

Common

  1. Requirements for the CSV File

    • Do not apply styles, colors, or additional formatting to the CSV.

    • Ensure all columns are correctly labeled and completed—empty fields will not be added.

    • Save the file as a CSV (.csv) format only.

    • The "TokenId", "Name" and "Description" columns are mandatory. Not having them in your CSV file can cause an error.

    • Token Name must be less than 100 characters.

    • Each token description must be less than 500 characters.

    • Each Attribute & Value name must be less than 100 characters.

    • Values from each Attribute must range from 0 to 50 units

Important Notes

  • Any errors in the CSV may result in upload failures or incorrect asset data. Review your file carefully before uploading.

  • If you previously uploaded assets or attributes, performing a bulk upload will replace them with the new data from your CSV file.

Last updated