Location and Search
Two product tabs that decide how a bookable product is found: Location gives it a place, and Search Builder controls the storefront search that helps customers discover it.
Location
| Setting | Default | What it does |
|---|---|---|
| Enable Location For This Product | Disabled | Turn location on for this product |
| Location / Address | empty | The address customers see |
| Latitude | empty | Map coordinate |
| Longitude | empty | Map coordinate |
| Show Location On Product Page | Enabled | Print the address above the booking form |
| Use Location In Search Results | Enabled | Let the search widget use it |
With location enabled and an address entered, the product page shows a line above the booking form:
Location: 14 Marine Drive, Mumbai 400020
Click Save Product Override to keep it for this product, or set it at global scope for a default.
Tips
Fill in latitude and longitude even if you are not showing a map yet — they are what a map view in search results needs, and they cost nothing to store.
Search Builder
The tab has two halves: the settings that control the storefront search, and a small test tool.
Search settings
| Section | Setting | Default | Meaning |
|---|---|---|---|
| Search Widgets | Enable Search Widgets | Enabled | Whether the search form works at all |
| Search Widgets | Default Widget Title | Find Availability | The heading above the form |
| Search Widgets | Lazy Load Results | Enabled | Load results as the customer scrolls |
| Filters | Enable Price Filter | Enabled | Offer a price filter |
| Filters | Enable Person Filter | Enabled | Offer a guest-count filter |
| Filters | Enable Resource Filter | Enabled | Offer a resource filter |
| Layouts | Default Search Layout | grid | grid, list or calendar |
| Layouts | Cards Per Row | 3 | 2, 3 or 4 |
| Layouts | Show Map View | Disabled | Add a map to the results |
| Global Search Config | Enable Global Search | Enabled | Search across all bookable products |
| Global Search Config | Maximum Results | 20 | How many results to return |
| Global Search Config | Cache Results (minutes) | 10 | How long to reuse a result set |
Tips
Turn Show Map View on only once your products actually have latitude and longitude. A map with no pins is worse than no map.
Where the search form goes
The search widget is placed on your site with a shortcode or a block — see Shortcodes and Blocks:
| Shortcode | What it renders |
|---|---|
[wcbrs_booking_search] | The Search / From / To form with a Find bookings button |
[wcbrs_booking_search_results] | The results list |
[wcbrs_available_bookings] | Products available in a window |
[wcbrs_bookable_products] | A list of your bookable products |
Results are labelled Available or Unavailable, and an empty search says "No matching bookable products found."
How results are presented
Three store-wide options under Product Settings → Global Settings → Storewide booking options:
| Setting | Options | Meaning |
|---|---|---|
| Search layout | Horizontal, Vertical, Modal-first | The shape of the search form |
| Search results mode | Inline, Modal, Redirect | Where the results appear |
| Redirect results page ID | A page ID | The page to send searchers to in Redirect mode |
| Search results to show | A number, default 20 | How many results to return |
Inline puts the results directly under the form. Modal opens them in an overlay. Redirect sends the customer to a page you have built with [wcbrs_booking_search_results] on it.
Important
If you choose Redirect, create the results page first, put the results shortcode on it, and then enter its page ID. Without a valid ID the search has nowhere to go.
The test tool
The lower half of the tab is a verification tool, not a customer feature:
| Control | What it does |
|---|---|
| From / To | The window to test |
| Search Availability | Runs an availability search for this product and shows the raw result |
| Load Global Calendar | Loads the calendar feed for the same window |
Both print their answer as raw data. Use them to confirm a rule you have just written really does open or close the window you expected — it is faster than switching to the storefront.
Note
The output here is deliberately technical. For a customer-facing view of the same information, open the product on your storefront and read the calendar.
Next step
- Calendar Sync — connect an external calendar.
- Shortcodes and Blocks — place the search form on a page.