Skip to content
Resrv
Esc
↑↓navigate↵open⌘Jpreview
On this page

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
{{ 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 availability search, with availability-results below it.

The availability search, with availability-results below it.

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 with enableQuantity starts 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"
/>

Was this page helpful?