web_bookings_finder Shortcode
The web_bookings_finder shortcode renders the bookings finder component.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Usage
[web_bookings_finder]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
date_picker |
input |
input, inline |
Controls the date picker. |
show_end_date_selector |
yes |
yes, empty |
Show the optional inclusive end-date selector. |
page_url |
— | String unless stated otherwise | Url of the page on which to display the results. You can leave it empty to make it the same page. |
start_date_label |
Start |
String unless stated otherwise | Controls the start label. |
start_date_placeholder |
Choose a date to see availability |
String unless stated otherwise | Controls the start input placeholder. |
end_date_label |
End |
String unless stated otherwise | Controls the end label. |
end_date_placeholder |
Choose a date to see availability |
String unless stated otherwise | Controls the end input placeholder. |
results_number_label |
Results found: |
String unless stated otherwise | Controls the results number label. |
template |
default |
default or a configured custom feed-template slug |
Selects the template used for each booking result. |
columns |
4 |
12, 6, 4, 3, 2, 1 |
Grid span: respectively 1, 2, 3, 4, 6 or 12 desktop columns; stacked on smaller devices. |
device_visibility |
— | web-hide-on-xs, web-hide-on-sm, web-hide-on-md, web-hide-on-lg, comma-separated |
Hide the whole finder in the selected device ranges. |
el_id |
— | Valid unique HTML ID | Enter section ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Integration requirement
This output requires the corresponding bookings integration and its source data to be available.
The form uses GET parameters start_date and optional end_date. New submissions use YYYY-MM-DD; valid old DD/MM/YYYY links still work. With no end date, the finder checks a booking starting on that day. A supplied inclusive interval must match an allowed product duration. For accommodation, the end is the final night and checkout is the following day. The native booking policy, resources and minimum party size apply.
Searches support at most 31 days and process the complete published booking catalogue in batches. The authenticated editor preview retains its 50-product and 2,000 candidate/resource/day work limits. Unavailable-integration states are explicit. Only currently visible, published, accessible products are shown. Result counts reflect rendered products. A custom template must still exist; default displays title-only fallback cards.
el_id, el_class and device visibility apply once to the wrapper containing both form and results. Generated input IDs are unique across instances. Existing theme datepicker assets are conditional on Finder presence; selected template and product-action assets are discovered when Bookings is active. Shortcode rendering remains available with the Legacy Page Builder interface disabled.
Exclude finder pages from upstream full-page caches. The theme requests cache bypass, but availability must still be confirmed on the product's booking form. Searching does not reserve a product.
See Search bookable products with Bookings Finder for the matching Gutenberg block and the verification checklist.
Verification
Test web_bookings_finder in its relevant logged-in and logged-out states, including validation, success and error feedback. Pay particular attention to date_picker and show_end_date_selector.