Metadata guidelines

Metadata is additional information provided when converting online products of partners into DOSI digital items. You can use metadata to add properties when issuing a type or sealing an online product for sale in the DOSI Brand Store.

The metadata of each digital item provided when sealing represents the product properties in the DOSI Brand Store. While the metadata of the item type provided when issuing the item type isn't visible in the DOSI Brand Store, but it's recorded on the blockchain and can still be used for partner services.

Requirements

You must provide metadata as follows.

• Format: JSON

• Key: String. Case sensitive. Between 1-15 characters (Recommended).

• Value: String. Case sensitive. Between 1-15 characters (Recommended).

  If the key or value exceeds 15 characters, DOSI can't print them out properly.

  • Objects or arrays aren't supported.
  • You can't directly input numbers or objects, but you can convert numbers or objects as a string.
    Example: 1 (Not allowed), "1" (Allowed)
  • You can use special characters, but it's not recommended as they may not appear properly on the screen.
  • Clearly specify lower and upper cases in consideration of how they are displayed on the screen for users.

• Maximum number of characters: 1,000 characters (Required)

  Since key and JSON grammar symbols are included, we recommend you enter a maximum of 700 characters.

Properties

You can add properties (or parts) of the digital item to the metadata. Properties are represented as a key-value pair in JSON, and the key is its name.

"Property name": "Value"

You can add up to 20 properties.

Property shown in DOSI

Let's say three properties are added to the metadata as follows.

{ "collection": "Platinum Pass Leta", "membership": "Platinum", "Hero name": "Leta" }

The key and value of those properties appear on the DOSI digital item page as shown below.

Change properties

When resealing, you can change the properties of the digital item by specifying metadata.