Filtering your iframe helps you to show your customers specific events on your schedule. You can do this by embedding different iframes within your website.
This article covers:
How to find your iframe code
To find your iframe code, select Customise page in the top-right-hand corner of your public page, then Embedded iframe link:
How to create filters
You can filter the iframe by entries, tags, locations, dates, single events and team members.
An example of an iframe code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
To add a filter, you would modify the URL (https://bookwhen.com/demo-website/iframe) by adding the filter code to the end of the URL.
For example, if filtered by date:
https://bookwhen.com/demo-website/iframe?start=2024-09-01
This would be the completed iframe code with the date filter added at the end:
Entry Filters
To filter your iframe by a specific entry, you will need the unique entry code, which you can find within the entry settings.
To find this, select the entry from your scheduling page, then Edit Entry:
You can find the code in the search bar:
Your filter iframe URL, in this case, would be appended with ?entry=extumtzw7jg8
An example of an unfiltered iframe code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
The completed iframe code with the entry filter code added at the end:
<iframe src="https://bookwhen.com/demo-website/iframe?entry=extumtzw7jg8" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
If you want to filter on multiple entries, we recommend using tags.
Tag Filters
Tags can be a powerful tool for presenting specific events to your customers while helping you organise multiple entries on your scheduling page by category, level, etc.
Single tag filter
You can use a single tag filter to present specific events to your customers, such as differentiating between "Child" and "Adult" classes.
Tag 1 = adults |
Tag 2 = children |
The single tag filter is helpful because you can reuse the tag name and iframe code, even if an entry is deleted. Add the same tag name to your new entry, and the filter will continue working.
To create a tag filter, you must first create a tag inside your entry. Once you have done this, you can start creating the code for the iframe.
The tag filter code:
?tags=
Then, add the tag-specific name to the code. For example:
?tags=tagname
An iframe example without the filter code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
An example of the iframe code with the tag "adults" added:
<iframe src="https://bookwhen.com/demo-website/iframe?tags=adults" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
The code with the "children" tag added:
<iframe src="https://bookwhen.com/demo-website/iframe?tags=children" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
💡 To note:
Tags are case-sensitive, so make sure your URL includes any capitals in the tag.
It's best to keep your tags as simple as possible and avoid using special characters.
If your tags have spaces such as "adult classes", you will need to replace the space in the tag in the URL with a '+' like this:
adult+classes
Filtering with multiple tags
Multiple tag filters can group specific event types. For example, if you assign the tag 'course' to all your course entries and then use the filtered iframe on your website, customers can easily view only the entries tagged as courses rather than your entire schedule.
You'll need to add the relevant tag to all entries you wish to include in this section. Once added, you can filter the iframe by adding the tag name at the end of the iframe URL code.
For example, the tag filter code:
?tags=
Then, add the tag-specific name to the code. For example:
?tags=tagname
An iframe example without the filter code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
An example of the iframe code with the tag "course" added:
<iframe src="https://bookwhen.com/demo-website/iframe?tags=course" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
Location Filters
To filter your entries by a specific location, you will need the unique location code for each location.
To find this, select Settings from the left-hand dashboard menu, then Locations. From here, find the location you wish to filter by, then select the Edit button:
Copy the code from the URL in the search bar (in between the 'location' and 'edit' part of the URL):
To filter your iframe only to show events from a specific location, add the following filter code to the end of your public booking page URL in your iframe code:
?location=
Then, add the location-specific code. For example:
?location=uenl08m9euah
An iframe example without the filter code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
The completed iframe code with the location filter code added at the end of the URL:
<iframe src="https://bookwhen.com/demo-website/iframe?location=uenl08m9euah" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
💡 To note: The filtered URL will only show entries with this exact location.
Date Filters
Date filters can help you organise your booking page to display events starting from a specific date onward. For example, if you run multiple events or classes each month, you can use this filter to help your customers easily find classes in specific months.
To filter your iframe only to show events from a specific date onwards, add the following filter to the end of your public booking page URL in your iframe code:
?start=
Then add the date you'd like the date to start from:
?start=2024-12-01
⚠️ You must ensure the date format is - YYYY-MM-DD.
An iframe example without the filter code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
The completed iframe code with the date filter code added at the end of the URL:
<iframe src="https://bookwhen.com/demo-website/iframe?start=2024-12-01" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
Single Event filters
If you'd like to embed your iframe for a specific event, you will need to ensure that you insert the URL extension from the View details page of the required event.
To do this. Open your public booking page, select the event you'd like to share from the schedule list, then View details from the right-hand side:
You can find the URL extension in the address bar. This code usually starts with /e/ and is added to the end of your public page link. For example:
You can add the URL extension to the end of the URL part of your iframe code. For example:
Team member filters
Filtering your iframe by specific Leaders is a great way to filter your page. To do this, select Account then Team before selecting the pencil and paper icon 📝 next to the leader.
Within the leader's profile settings, you can find the code at the end of the URL in the search bar:
To filter your iframe only to show events with a specific leader, add the following filter to the end of your public booking page URL in your iframe code:
?leader=
Then, add the leader-specific code. For example:
?leader=zz3otovn0r33.
An iframe example without the filter code:
<iframe src="https://bookwhen.com/demo-website/iframe" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
The completed iframe code with the leader filter code added at the end of the URL:
<iframe src="https://bookwhen.com/demo-website/iframe?leader=zz3otovn0r33" frameborder="0" scrolling="yes" seamless="seamless" style="display:block;border:none;width:100%;height:900px;"></iframe>
💡 To note: The filtered iframe URL will only show the assigned entries of this particular leader.
Important notes about the iframe
The iframe will only display your schedule, events and alert banner. It doesn't include banner images, buttons, the footer or any other additional edits on your page.
Once a ticket has been selected, the booker cannot return to the schedule. They must select all tickets under one filter at once; if they return to the schedule, the filtered view will not appear unless the page is refreshed.
The booker won’t be able to select tickets using more than one iframe filter; the basket selection will update as soon as they switch to a new filter within the website.
💬 Any questions or feedback? There are two ways to get in touch:
For a quicker response, please contact us via live chat on our homepage or your account.
Or send us an email
Thank you! 🕺