Availability Search Overview
The availability-search component is the search form visitors use to pick their dates, and optionally a rate and a quantity. You pair it with a component that shows what’s available.
Which component to use
| You want | Use |
|---|---|
| Availability of one entry on its page | availability-results |
| Upcoming available dates for one entry | availability-list |
| A cart of several rates or dates for one entry | availability-multi-results |
| Many entries of a collection, live, no extra package | availability-collection |
| Many entries, with availability as one filter among others | lf-availability-filter (requires reachweb/statamic-livewire-filters) |
| Many entries, server-rendered with a page reload | the resrv_search collection-tag query scope |
Adding the search
{{ livewire:availability-search calendar="range" }}
Resrv saves each search in the visitor’s session, so it carries over to other pages. A saved rate that doesn’t apply to the current entry is dropped, and when there’s only one rate, it’s selected for the visitor.

The quantity on other pages
A search without enableQuantity sets the saved quantity back to 1 when the page loads, so a quantity picked in another page’s search isn’t priced and booked here.
- Results, lists and collections use the reset only when they render after the search. Statamic renders the page template before its layout, so a search in your layout, like a header bar, takes effect from the next page load. To price one unit straight away, put the search in the page template.
- On a page with two searches, the first to render decides. After a search with
enableQuantity, a search without it keeps the visitor’s quantity. In the other order, the search withenableQuantitystarts at 1. - A page with results, lists or collections but no search keeps the saved quantity, so a search that redirects there still carries its quantity.
Properties
| Property | Default | Description |
|---|---|---|
calendar |
single |
single picks one date, range picks a date range. |
live |
true |
Updates the results as the visitor changes their search. Set it to false to search only when they press Search. |
redirectTo |
With live off, the URL to send visitors to when they press Search. Without it, the results on the same page update. |
|
rates |
false |
Shows the rate selector. Pass :rates="true". |
anyRate |
false |
For multiple entries: with no rate selected, searches every rate and shows the cheapest. It also allows searching without dates. Pass :any-rate="true". |
enableQuantity |
false |
Adds a quantity picker, so visitors can book more than one at once. Without it, the search sets the quantity back to 1. Turn it on for any search whose view sets data.quantity itself, like the Guests component. |
overrideRates |
[] |
Your own rate_id => label map for the rate selector. |
showAvailabilityOnCalendar |
false |
Shows availability and prices on the calendar. Only for a single entry, and needs entry. |
entry |
An entry ID, to load that entry’s rates. | |
ratesBlueprint |
A collection.blueprint, mainly for Livewire Filters. |
|
view |
availability-search |
A custom view in resources/views/vendor/statamic-resrv/livewire, for example a different search form on your home page. |
A search form on another page
To put a search form on your home page that sends visitors to a results page, turn off live and set redirectTo:
{{ livewire:availability-search calendar="range" live="false" redirectTo="/rooms" }}
The results page picks up the search from the session. For the results themselves, see single entry or multiple entries.
Setting the search via URL parameters
You can fill in the search from a link, for example in a newsletter. This opens the page with the dates set and the results loaded:
https://yoursite.com/villa-blue?date_start=2026-08-20&date_end=2026-08-25&rate=3
| Parameter | Example | Description |
|---|---|---|
date |
?date=2026-08-20 |
The start date. The end date follows your minimum reservation period. |
date_start and date_end |
?date_start=2026-08-20&date_end=2026-08-25 |
An exact date range. |
rate |
?rate=3 |
A rate by its ID, or any when anyRate is on. |
Dates use the YYYY-MM-DD format. The link replaces any search saved in the session, so a link with dates but no rate doesn’t keep a rate the visitor picked earlier. Invalid values, like a past date, are ignored. On a form that redirects (live off with redirectTo), the link fills in the form but the visitor still presses Search.
Passing data to checkout
You can send values from the search to the checkout form, like the number of guests from the Guests component. Bind your control to data.customer.<handle>, and add a field with the same handle to your checkout form. To stop visitors changing it at checkout, make that field hidden.
Customizing
The search form is plain by default, so you can match it to your site. Publish the views:
php artisan vendor:publish --tag=resrv-checkout-views
Then edit resources/views/vendor/statamic-resrv/livewire/availability-search.blade.php. The parts it uses are in the components folder next to it, like the rate selector in availability-rates.blade.php.
Disabling days of the week
To stop visitors picking certain days, add disabledDays to the dates component in your published availability-search.blade.php, with full English day names:
<x-resrv::availability-dates
:$calendar
disabledDays='["Saturday", "Sunday"]'
:errors="$errors"
/>