Skip to main content

session

Type: string
Possible values: 'continue', 'start', 'manual', 'none' Default: 'none'

Start a session to temporarily hold objects upon selection.

A session lasts for 15 minutes (or whatever you set on your settings page), from the moment the chart gets rendered. When the ticket buyer clicks on a place within that period, it gets held. Other users won't be able to book the same place within that period. If the place is not booked (e.g. payment has never been received) before the end of the session, it's automatically released again.

A session is identified by a hold token. Consider this the session ID. When starting a session, we store the hold token in session storage, so it's still available after a page refresh.

  • 'continue': continue a previously started session by using the hold token in session storage, or start a new session if there's no hold token.
  • 'start': start a new session (and generate a new hold token).
  • 'manual': continue the session identified by holdToken. Use this when you generated a hold token through our backend API.
  • 'none': session is disabled. Objects don't get held on click.

This article gives a more in-depth overview of the holding seats functionality.

Note

Sessions start when the chart is rendered, not when the first seat gets selected. So if the ticket buyer selects a seat 6 minutes after rendering, it will only be held for 9 minutes.

Note

To keep the session (or shopping cart) of your own site in sync with the seats.io session, you can change the expiration date of the seats.io session.