> For the complete documentation index, see [llms.txt](https://docs.manifold.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.manifold.xyz/manifold-for-developers/resources/widgets/marketplace-widgets/widgets/listing-widgets.md).

# Listing Widgets

Individual widgets, prepended by `m-listing-`, are standalone widgets that pull specific data from a listing. They are exported to give creators more freedom as to how they want to organise their listing page.

<details>

<summary>m-listing-attributes</summary>

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FBQb2gsM2J51GE29mSwYN%2FMListingAttributes-3.2.0.png?alt=media&amp;token=fa9869c3-6dc4-4883-873e-9a49d5544d93" alt="" data-size="original">

Displays the attributes and their values for the token.

```html
<div
  data-widget="m-listing-attributes"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-bid-form</summary>

Shows an input field for the bid and a CTA. It displays nothing when the listing has ended (replaces the parent div with a comment, `<!---->`).

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FFFwln0Hm5OeFcFLV8wWb%2FMForm-3.2.0.png?alt=media&amp;token=298f9c4b-fefa-4d54-aead-620c0a9eb483" alt="" data-size="original">

```html
<div
  data-widget="m-listing-bid-form"
  data-address="CONTRACT_ADDRESS"
  data-id="LISTING_ID"
  data-network="NETWORK"
  data-version="2"
></div>
```

</details>

<details>

<summary>m-listing-bid-form-rich</summary>

Contains text for the minimum bid or offer/bid or offer status, the current bid currency, and the balance of the connected wallet. Displays nothing (`<!---->`) if the listing has ended.

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2F6qnd9bBTylSiopErjHb8%2FMRichForm-3.2.0.png?alt=media&amp;token=67678658-45d3-476a-a61e-bf71f51e78f3" alt="" data-size="original">

```html
<div
  data-widget="m-listing-bid-form-rich"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-countdown</summary>

Displays a countdown ticker for the auction or the appropriate if the listing has not yet started/has ended.

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FHd6FsTX1ATtj5wufQrSW%2FMCountdown-3.2.0-pending.png?alt=media&amp;token=d66d8e96-079f-4f23-8baf-0634b6a272a1" alt="" data-size="line">

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FOslc45yI8447AHjCjTt5%2FMCountdown-3.2.0.png?alt=media&amp;token=2cacfb4f-4011-4483-8ecc-f6fd2f645701" alt="" data-size="original">

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FTHAAidDwCiPS0i1hmgPN%2FMCountdown-3.2.0-ended.png?alt=media&amp;token=10f9c22c-9647-487e-a678-b7e3c0c018eb" alt="" data-size="original">

```html
<div
  data-widget="m-listing-countdown"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-description</summary>

Loads the token's on-chain description.

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FlVqSpwHfxxM4TB0euHxo%2FMDescription-3.2.0.png?alt=media&amp;token=1bf36078-2543-41d3-b941-ea0737127bf3" alt="" data-size="original">

The equivalent HTML code looks something like this:

```html
<div class="m-description">
  ::before
  <p>test</p>
</div>
```

The `::before` pseudo-component contains the “DESCRIPTION” header.

```html
<div
  data-widget="m-listing-description"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-interactions</summary>

**\[Updated name] In versions < 3.2.0:** `m-listing-bids`.

Shows the listing's bid/offer history as a table.

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FQCjFvRQJIAjmZ3yBvfx6%2Fminteractions-bids-light.png?alt=media&amp;token=7e3a544a-6422-49fc-b49e-b98c8e5b6f6c" alt="" data-size="original">

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FCMmym4JJT4k8BOEARmMS%2Fminteractions-offers-dark.png?alt=media&amp;token=1b15a16e-3ad0-44f2-a84d-0a271541d50d" alt="m-listing-interactions: offers, dark" data-size="original">

```html
<div
  data-widget="m-listing-interactions"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-image-expandable</summary>

Displays the listing media and a floating action button on the bottom-right to allow for expanding the media into a full-screen view.

<img src="https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FkAyXTjHtcAl15KqbvS2a%2FMExpandableImage-3.2.0.png?alt=media&amp;token=0ad365e2-b33c-4647-82d8-e7cdf9b81c9b" alt="" data-size="original">

```html
<div
  data-widget="m-listing-image-expandable"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

To customize the widget background, provide a [`data-media-background`](/manifold-for-developers/resources/widgets/marketplace-widgets/widgets/data-attributes.md#data-media-background) prop.

</details>

<details>

<summary>m-listing-inventory</summary>

For ERC-1155 listings only. Displays the following text

```jsx
${ tokenRemaining } of ${ tokenMax } left
```

when `tokenRemaining > 0` with a progress bar above it.

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2Fbu4jiG4zRuHA1dwi3yRq%2FMInventory-3.2.0-light.png?alt=media\&token=f9a3d2b4-2759-40b2-99e4-9acc426aef92)

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FYMZqgdyMaX6MMp9ueC3G%2FMInventory-3.2.0-dark.png?alt=media\&token=5acd639c-b4b9-48b2-a435-867627b5633a)

When `tokenRemaining = 0`, we display

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2F9PON7Pc21aGkEKyJhCOY%2FMInventory-3.2.0-soldout.png?alt=media\&token=48aaffae-40cc-466e-8d42-a79516d18faf)

`tokenRemaining` and `tokenMax` come from the `listing` details (`listing.totalSold` and `listing.totalAvailable` respectively).

```html
<div
  data-widget="m-listing-inventory"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-links</summary>

Shows a list of links related to the listing.

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FtNfczcxJn6lhsSU0n8sV%2FMLinks-3.2.0-light.png?alt=media\&token=0e8b9bf7-c25b-4325-acef-59dc4f3b0ad6)

```html
<div
  data-widget="m-listing-links"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-minted-counter</summary>

For ERC-1155s listings only. Displays the following text

```jsx
`${amount_of_tokens_minted} out of ${max_mintable_token_amount} minted so far`
```

where `amount_of_tokens_minted` and `max_mintable_token_amount` are pulled from the `listing` details (`listing.totalSold` and `listing.totalAvailable` respectively). Also has a progress bar above the counter text. Similar to `m-listing-inventory`.

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FiTQSpMzSCK4PcpE64eX5%2FMMinted-3.2.0-light.png?alt=media\&token=83b9d741-2464-4922-bb0a-b91113a58bf3)

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2Fu1MqFsMIeiKFJA08iQvH%2FMMinted-3.2.0-dark.png?alt=media\&token=70e3ba41-5062-4880-8871-a8d8d1970f05)

```html
<div
  data-widget="m-listing-minted-counter"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-name</summary>

Displays the name of the listed token in a span. Pulls the data from on-chain.

![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2F4ceiaQ3PWgUlHFrX1kAl%2FMName-3.2.0-light.png?alt=media\&token=85da0d6e-81e1-4363-b752-5ff5a00f0384)

```html
<div
  data-widget="m-listing-name"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>

<details>

<summary>m-listing-price</summary>

Displays the listing price’s label and the listing’s price, along with a bid status if the listing is an auction and the user has participated in the bid.

The listing label is one of the following:

* “Bidding Starts At” — if the listing is of type auction, is still ongoing, and does not have any bids.\
  ![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FLdRYEVhPwDwKLtQsfruw%2FMPrice-3.2.0-reserve.png?alt=media\&token=fca8a466-6e25-4020-ab17-a1860d348954)
* “Price” — if listing is not of type auction or if the listing has ended and there is a current bid amount.\
  ![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FZFY9odxYONSA6nNEg7JD%2FMPrice-3.2.0-1155.png?alt=media\&token=8e79d7e0-4436-4884-b757-d339a11109a3)
* “Current Bid” — if the listing is of type auction, is still ongoing, and has at least one bid.\
  ![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FTLo3intnajvfAxFRXEAc%2FMPrice-3.2.0-current.png?alt=media\&token=3a705bc1-c4dd-4c7d-9ff1-be06bb62c438)
* “Winning Bid” — if the listing is of type auction, has ended, and has a current bid amount.\
  ![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FyvnS6PPBpIx3mFcmeoIL%2FMPrice-3.2.0-winning.png?alt=media\&token=b63efe9b-adb8-4d41-a4d4-83904af748a3)

If the listing is a ranked auction, the price widget also displays the highest offer and the floor value.\
![](https://268636785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8n4plerMUJrsrAiaKpc2%2Fuploads%2FtyabbobwWbspc5RjPfrW%2FMPrice-3.2.0-offers.png?alt=media\&token=0a9bc7af-249a-4d2f-9ead-28293550fab4)

```html
<div
  data-widget="m-listing-price"
  data-id="LISTING_ID"
  data-network="NETWORK"
></div>
```

</details>
