# Importing Assets & Metadata

NiftyKit simplifies digital asset management by enabling **direct asset and metadata uploads** without third-party apps. Our import tool will upload your assets directly to IPFS, saving time and ensuring asset accessibility and safekeeping. 

[-> Check supported file types here](https://docs.niftykit.com/get-started/getting-started/file-asset-size-and-requirements)

<figure><img src="https://3542085034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyrUuRLqblqKRfJtuslV7%2Fuploads%2FICNXA84so1sRVYSBCSJt%2Fimage.png?alt=media&#x26;token=47b09ae1-ecec-4c42-b2b8-6523cad559e0" alt="" width="563"><figcaption><p>Import Asse: How to bulk upload NFTs using NiftyKit</p></figcaption></figure>

## Prerequisites

1. File names should be numerical (eg. 1.png, 2.png, 3.png, etc) otherwise the token IDs will be assigned randomly.
2. Assets should already be generated and in a single layer.&#x20;
3. Save metadata in NiftyKit API (Recommended)
4. For CSV or JSON files, it must follow the exact template below. Otherwise, it cannot be read by our system.

{% file src="<https://3542085034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyrUuRLqblqKRfJtuslV7%2Fuploads%2F1Qh1NV4eotEx7iLcJOmY%2Fsample-metadata.zip?alt=media&token=aa0772e2-3252-4bf1-9363-0e02ac011975>" %}
Sample  CSV with no image link
{% endfile %}

## How to upload assets and metadata?

There are two ways to upload your assets.

1. Upload assets separately with metadata
2. Upload CSV or JSON with IPFS links of your assets

<figure><img src="https://3542085034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyrUuRLqblqKRfJtuslV7%2Fuploads%2F6o5pblnM1B61BmM40qR9%2Fimage.png?alt=media&#x26;token=b6ca2451-11ca-4b3f-b717-1b13a87a288d" alt="" width="375"><figcaption><p>How to Import Assets to your NFT collection</p></figcaption></figure>

## [Ready to import assets?](https://app.niftykit.com/login)

#### [-> Import now](https://app.niftykit.com/login)

When utilizing the Import Metadata feature, you can either upload a file of just metadata or a combination of assets (images, videos, gifs) and metadata.

Note that when uploading metadata, the following are **optional fields:**&#x20;

* image
* animation\_url,&#x20;
* background\_color,&#x20;
* youtube\_url, and&#x20;
* external\_url.

Including an image field in your CSV or JSON file will override any previously uploaded images for that specific NFT.

Uploading a CSV or JSON with an image field will override any previously uploaded image.

If you upload image files and metadata already exists, we will update only the images. For example, if you have already uploaded ten tokens and uploaded image 5.png, we will update the image for token #5.

{% hint style="info" %}

{% endhint %}

<figure><img src="https://3542085034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyrUuRLqblqKRfJtuslV7%2Fuploads%2Fh2oeUbO8EDd1n0Hy4PEt%2Fimage.png?alt=media&#x26;token=6320af4a-cea8-492b-9cb6-7fe538c8ef88" alt=""><figcaption><p>This is a sample CSV file when uploading metadata only.</p></figcaption></figure>

<figure><img src="https://3542085034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyrUuRLqblqKRfJtuslV7%2Fuploads%2FiYUgeQfvUIoMKfYYjX9G%2Fimage.png?alt=media&#x26;token=6b1efca8-30a7-4df1-b66b-cdef6994164e" alt=""><figcaption><p>This is a sample CSV file when uploading both assets and metadata.</p></figcaption></figure>

As an alternative, you can also add or edit the metadata directly from your dashboard. Just click on **\[EDIT]** next to the asset you want to edit, click **\[ADD PROPERTY],** enter the traits, and then **\[SAVE].**

## [**Ready to upload your metadata?**](https://app.niftykit.com/login)

#### [-> Upload metadata to your Collection here](https://app.niftykit.com/login)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.niftykit.com/nft-collections/collection-management/importing-assets-and-metadata.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.