> ## Documentation Index
> Fetch the complete documentation index at: https://pindocs.jackalprotocol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a Collection

> Jackal Pin supports entire folder uploads

For the purposes of this demo, I will be uploading the following folder named: `jkl-ipfs-test`.
The folder has 2 `.txt` files stored inside.

<Note>
  If you are uploading NFT assets, pretend the `.txt` files are your image
  assets.
</Note>

<img src="https://mintcdn.com/test-1f221df8/i5glYxYtfc1hfTiV/images/upload-folder.png?fit=max&auto=format&n=i5glYxYtfc1hfTiV&q=85&s=956d5fa09fd11e2afa9e1724b2c301a1" width="1840" height="874" data-path="images/upload-folder.png" />

<Steps>
  <Step title="Drag and drop a folder">
    You can drag and drop a folder directly into Pin and it will create a collection with the
    folder name and sort the files inside, preserving file structure.

    Dragging a folder pin should trigger the screen below.

    <img src="https://mintcdn.com/test-1f221df8/i5glYxYtfc1hfTiV/images/drag.png?fit=max&auto=format&n=i5glYxYtfc1hfTiV&q=85&s=22c129a114a40d1940a9f760784e6b85" width="2940" height="1344" data-path="images/drag.png" />
  </Step>

  <Step title="View Uploaded Collection">
    After the upload is successful, you can see that the folder supports the structure of the uploaded folder.

    <img src="https://mintcdn.com/test-1f221df8/i5glYxYtfc1hfTiV/images/ipfs-collection.png?fit=max&auto=format&n=i5glYxYtfc1hfTiV&q=85&s=76a74189f46ed1c85e0dd54660bdcca5" width="2940" height="610" data-path="images/ipfs-collection.png" />
  </Step>

  <Step title="Retrieving collection cid">
    By clicking on the cid of the folder you want to retrieve, you will
    automatically copy it. The cid will be that of the entire collection.

    <img src="https://mintcdn.com/test-1f221df8/i5glYxYtfc1hfTiV/images/collection-cid.png?fit=max&auto=format&n=i5glYxYtfc1hfTiV&q=85&s=f3652c9c93cd325dd28914a1d9599401" width="2938" height="1542" data-path="images/collection-cid.png" />
  </Step>
</Steps>

## Using Your Collection CID

Once you've successfully uploaded your collection, you can use the CID in various ways:

* **For NFT Assets**: Use the collection CID to reference your entire asset folder in NFT projects
* **In NFT Metadata Files**: Include the CID in your NFT metadata JSON files to link to images and other assets
* **For NFT Marketplaces**: Use the CID when minting or listing NFTs on platforms like [Stargaze](https://www.stargaze.zone)**.**
* **For NFT Smart Contracts**: Reference the CID in your smart contracts for on-chain verification of assets
* **For NFT Galleries**: Create decentralized galleries that display your NFT collections using the CID

The CID serves as a permanent, content-addressed identifier for your entire NFT
collection, ensuring your digital assets remain accessible and verifiable on the
IPFS network for collectors and marketplaces.