Experience slot calendar
The experience_slot_calendar tag generates a calendar showing availability and pricing for Experience products.
The experience_slot_calendar tag generates a calendar for one or more Experience products.
Within the tag, a Calendar object is made available. Each Date provides availability for that day, including slot count, sold-out status, display price, remaining stock, and slots grouped by variant.
For narrative examples and month navigation patterns, see the Experience slot calendar guide.
Unlike product_search and experience_slot_search, experience_slot_calendar does not automatically use values from the search query parameters. Pass parameters explicitly to the tag when you want URL-driven behaviour.
Parameters
| Parameter | Required | Description |
|---|---|---|
experience | ✓ | A ProductDrop, product ID, or an array containing either. |
month | Month number (1–12). Must be provided together with year. | |
year | Four-digit year. Must be provided together with month. | |
variant_id | Filters the calendar to slots for a specific variant. | |
guest_count | Number of guests (defaults to 1). Affects sold-out and remaining-stock calculations. |
When both month and year are omitted, the calendar defaults to the month containing the next available slot, or the current month if none exist.
input
{% experience_slot_calendar experience: product, month: 2, year: 2024 %}
<ul>
{% for date in calendar.dates %}
<li>
{{ date.date | date: "%Y-%m-%d" }}
{% if date.slot_count == 0 %}
(no availability)
{% elsif date.sold_out %}
(sold out)
{% else %}
(from {{ date.display_price.fractional | money }})
{% endif %}
</li>
{% endfor %}
</ul>
{% endexperience_slot_calendar %}output
<ul>
<li>2024-02-01 (from £18.00)</li>
<li>2024-02-02 (from £18.00)</li>
<li>2024-02-04 (sold out)</li>
<li>2024-02-14 (no availability)</li>
</ul>