Skip to main content

listings

A listing is a group of seats that are usually put up for sale together at a certain price.

On the chart, a listing is shown with a price marker: a label that draws attention to the listing and shows its per-seat price.

You define listings with the listings configuration parameter. Each listing has:

  • id: a unique identifier for the listing.
  • objects: the labels of the seats in the listing.
  • listingType (optional): the name of a listing type, used to show a badge on the listing's price marker.
  • selectAsGroup (optional): whether the listing is selected as a single group. Defaults to true, which means that selecting one seat of the listing selects them all. Set it to false to let users select the seats individually.
listings: [
    { id: 'vip', objects: ['A-1', 'A-2'], listingType: 'premium' },
    { id: 'value', objects: ['B-5', 'B-6', 'B-7'], selectAsGroup: false }
]

Pricing a listing​

You can give a listing its own price by referencing its id in the pricing configuration. See pricing per listing.

If you don't set a price for the listing, its seats keep their normal category pricing.