> For the complete documentation index, see [llms.txt](https://cryptoart.gitbook.io/cryptoart/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cryptoart.gitbook.io/cryptoart/tokens/metadata.md).

# Metadata

* `tokenid`:  The unique ID of the token
* `name`:  Title of the art piece + edition number.  e.g. Patriot #1/35
* `description`:  Art piece description
* `image`:  IPFS location of the image associated with the art piece
* `ref`:  Optional further reference associated with the art piece.  e.g. Some early Bitcoin thematic artworks are inscribed as Ordinals.  If the token is derived from a vaulted 1/1 NFT, the address will be referenced here. 
* `artist`:  Name of the artist. 
* `category`: Art
* `external_url`:  External link to the art piece on cryptoart.com
* `group_id`:  An ID that allows for grouping of related art pieces. Often used to works by the same artist.
* `img_group_id`:  An ID that allows for additional grouping inside a `group_id` .  Often used to group different sizes of a similar image.
* `attributes[]`:  Trait types (used for filtering on marketplaces)
  * <mark style="color:$warning;">`Redeemable`</mark><mark style="color:$warning;">:</mark> Declares if the token can be redeemed for a physical art piece.  `Redeemable = TRUE` is redeemable.   `Redeemable = FALSE` has already been paired with a valid physical.
  * `Redemption Size`:  The size of the physical art piece that can be redeemed.  "Any" mean it can be redeemed for any size.
  * `Year`:  Year the art piece was created
  * `Original Medium`:  The original medium used to create the art piece.  e.g. "Digital Art", "Physical Oil"
  * `Acquisition Method`:  How the art was incorporated into the collection (Submission / Commission / Vaulted)
  * `Creator Type`:  Human
  * `Edition Number`:  Number of the art piece in a limited edition series. e.g. `1` / 35.
  * `Edition Supply`:  Supply count of the edition. e.g. 1 / `35`:

{% hint style="info" %}
To ensure scarcity, Cryptoart tokens can only be paired with one physical artwork.  Before buying a token, make sure `Redeemable = TRUE` if you plan to pair it.&#x20;
{% endhint %}