List items (legacy)

caution

This is legacy documentation used by existing Mavis Store clients. New users should refer to this guide: Manage items.

Overview

This guide describes how to list items in your store on the Mavis Store platform. After an item is listed, it's displayed among other items in your storefront and on its own item details page.

To list items, fill in their information in the provided CSV template, then share the file with your Sky Mavis partner engineer.

Prerequisites

Complete the steps in Register as a merchant.

List items

1. Download the CSV file template from Google Drive.
2. Fill out the Item info tab according to the description of each field in the table that follows.

Field name	Type	Required or optional?	Description
sku	String	Required	Unique alphanumeric ID of the item.
item_name	String	Required	Name of the item.
description	String	Required	Description of the item displayed on the item details page.
unit_price	Float	Required	Price of the item.
before_discount_price	Float	Optional	Price of the item before discount.
currency	String	Required	Currency of the item's price. One of the following currencies: Fiat: USD Token: RON, USDC, AXS, SLP, WETH
tag	String	Optional	Special tag of the item. For example: "Welcome bundle."
is_featured	Boolean	Optional	Defines whether the item is featured on the merchant's store page. You can mark up to two items as featured. The default value is false.
is_personalized	Boolean	Optional	Defines whether the item uses the advanced integration level. The default value is false.
image_link	String	Required	URL of the primary image of the item: Size: 1080x1080 pixels Must meet the common image requirements.
additional_image_link_1	String	Optional	URL of an additional image of the item: Size: 1080x1080 pixels Must meet the common image requirements.
additional_image_link_2	String	Optional	URL of the second additional image of the item: Size: 1080x1080 pixels Must meet the common image requirements.
additional_image_link_3	String	Optional	URL of the third additional image of the item: Size: 1080x1080 pixels Must meet the common image requirements.
unit_title	String	Optional	Unit of the item in your game. For example, gem for Axie Infinity Origins or Gas for Battle Bears.
unit_quantity	Integer	Optional	Quantity of the units of the item that the buyer receives for the price paid.
unit_image	String	Optional	URL of the item's icon in the game. Size: 128x128 pixels Must meet the common image requirements.

Common requirements

The common requirements are requirements that apply to multiple fields in the preceding table.

Images

When adding image URLs, ensure the following:

• The image URL is a link to the main image of your item.
• The image URL starts with http or https.

The image itself must adhere to the following requirements:

• The image accurately displays the item.
• The image is a JPEG or PNG file.

Next steps

Integrate with Mavis Store API