Filtering your public booking page or iframe is really useful for showing your bookers only specific events on your schedule, when creating filter buttons or when embedding different iframes within your own website.

This guide covers:


How to create filters

The public page can be filtered on dates, locations, entries and tags by adding filters to the URL.

Your unfiltered public booking page URL will look like this (this example page is called grow):

https://bookwhen.com/grow

We have a Google Sheet that can help you to construct both filtered links and filter buttons. Just click here to open the Google sheet then select Make a copy and follow the instructions.

If you prefer to construct your filtered link manually just follow the steps outlined below.


Date Filters

To filter your page to only show events from a specific date onwards, add the following filter to the end of your public booking page URL:

?start=2022-01-01

You must ensure the date format is - YYYY-MM-DD.

For example:

https://bookwhen.com/grow?start=2022-01-01


Location Filters

To filter your entries by a specific location you will require the unique location code, which you can find in that location's edit page. You can find your locations under Settings then Locations:

Then select the location you wish to filter by and take the code from the URL:

Now you can create your filter URL, which in this case would need to be appended with ?location=epojhv6suohe

Here's how that would look:

https://bookwhen.com/grow?location=epojhv6suohe

Please note that the filtered URL will only show entries with this exact location.


Entry Filters

Entry Filters work in the same way as location filters. You can get the entry code from the URL when editing the entry:

Your filter URL, in this case, would be appended with ?entry=8yr7put8ede4

Here's how that would look:

https://bookwhen.com/example?entry=8yr7put8ede4


If you wanted to filter on multiple entries, we would recommend using tags, see below.


Tag Filters

Tags are a great way to group different entries. For example, you might want a tag for all your adult classes, and one tag for all your children's classes. 

Tag 1 = adults
Tag 2 = children

Once you've applied these tags to your relevant entries, you can easily filter by these, by just adding ?tags=adults or ?tags=children

Here's an example:

https://bookwhen.com/example?tags=adults


Please note:

  • Tags are case sensitive, so make sure your URL reflects any capitals in the tag.

  • It's best to keep your tags as simple as possible and avoid using any special characters.

  • If your tags have spaces, like "adult classes", you will need to replace the space in the tag in the URL with a '+' like this:

https://bookwhen.com/example?tags=adult+classes


Using your filters

Now that you've created filter URLs you can insert these to make it easier for your customers to navigate your booking page. In your public page description, you can either link out to your filtered pages, create hyperlinks or use create filter buttons like this:

Read how to create filter buttons here and view the above as a live example here.


Filtering iframes

You can filter iframes in exactly the same way as you would filter a public page URL. If for example, you have copied the following iframe code from the public page settings:

<iframe src="https://bookwhen.com/example/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>

You would modify the URL in the iframe code by adding the filter section to the end like in this example: https://bookwhen.com/example/iframe?start=2020-01-01

This will mean the iframe code you end up using will look something like this:

<iframe src="https://bookwhen.com/example/iframe?start=2020-01-01" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>

Did this answer your question?