Filtering your iframe allows you to display specific events from your schedule, giving your customers a more tailored experience.
By embedding different iframes on your website, you can customise the events that are shown to meet your needs.
This article covers:
Demo page
To help you explore the possibilities, we’ve created a demo website that showcases the various iframe filters you can use with Bookwhen.
How to find your iframe code
To find your iframe code:
Open your public page.
Select Customise page in the top-right-hand corner of your public page, then Embedded iframe link:
The code that appears underneath the Embedded iframe option is the iframe code.
How to create filters
You can filter your iframe by:
Entries: Show only selected events.
Tags: Filter events by category or type.
Locations: Display events happening at a specific place.
Dates: Show events from a certain date onward.
Single Events: Focus on just one event.
Team Members: Show events run by a specific leader.
Example 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>
Adding a Filter
You'll need to modify the iframe URL by adding a filter code at the end. For example:
Copy and paste the iframe code into your website.
Add a filter to the URL part of the code (e.g. https://bookwhen.com/demo-website/iframe)
For example, to show events starting from 1st September 2024, add ?start=2024-09-01 to the end of the URL:
https://bookwhen.com/demo-website/iframe?start=2024-09-01
4. Replace the iframe code with your new filtered URL:
Entry Filters
To display a specific event in your iframe, you’ll need its unique entry code.
How to find the entry code
Open your scheduling page, select the event you want to filter, then Edit entry:
The code is in the URL bar at the top. For example https://admin.bookwhen.com/entries/extumtzw7jg8/edit :
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 display multiple events instead of just one, we recommend using tags for filtering.
Tag Filters
Tags help organise your schedule and let you display specific events to customers. You can filter events by categories like age group, level, or type of class.
Benefits of Tag Filters
Allows you to show only relevant events (e.g., "Adult" or "Child" classes).
Works even if an entry is deleted—just assign the same tag to new entries.
Keeps your schedule organised and easy to manage.
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 |
How to Use Multiple Tag Filters
Modify your iframe URL by appending the tag filter code.
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: Use the exact capitalisation in your URL.
Avoid special characters in tag names.
If your tag has spaces (e.g., "adult classes"), replace the space with + in the URL:
adult+classes
💡 Need more filter options? Learn how to use special characters in your filter code.
Filtering with multiple tags
Using multiple tag filters allows you to group specific event types. For example, if all course entries have the "course" tag, you can create a filtered iframe so customers only view courses instead of your entire schedule.
How to Use Multiple Tag Filters
Modify your iframe URL by appending the tag filter 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 display a specific location in your iframe, you’ll need its unique location code.
How to find the location code
Select Settings from the left-hand menu on your account, then Locations.
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>
Date Filters
Date filters help organise your booking page by displaying events starting from a specific date onward. This is useful if you run multiple events each month and want customers to find classes for a particular period easily.
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
To display a specific event in your iframe, you’ll need its unique event code.
How to find the location code
Open your public page, select the event, then View details:
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 by specific team members helps customers find events led by their Leaders.
To do this:
Select Account on the left-hand menu on your account, then Team.
Select the pencil and paper icon 📝 next to the leader to open their profile settings.
Within the leader's profile settings, you can find the code at the end of the URL in the search bar:
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>
Important notes about the iframe
What the iframe displays
The iframe will only show your schedule, events, and the alert banner. It won't include any additional elements such as banner images, buttons, the footer, or other custom edits made to your page.
Ticket selection process
Once a ticket is selected, the booker cannot return to the schedule. They must select all tickets under one filter at once.
If the booker returns to the schedule after selecting tickets, the filtered view won't reappear unless the page is refreshed.
Iframe filter limitations
A booker cannot select tickets using more than one iframe filter at the same time. If they switch to a different filter on your website, the basket selection will automatically update.
💡 Learn more about iframe limitations and how to embed Bookwhen within your website.
💬 Need extra help?
For the quickest response, contact us via live chat on our homepage or your account. Buddy, our trusty chatbot, will assist first and pass you to a support team member if needed.
Prefer email? Send us an email instead.
Thank you! 🕺