Skip to main content
Filtering the iframe

Learn how to filter your iframe using entries, tags, dates, locations or team members

Luisa avatar
Written by Luisa
Updated over a week ago

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:

Customise page settings with an arrow pointing at the 'Embedded iframe' button, highlighting to users where they can click to copy their iframe code.




​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:


This would be the completed iframe code with the date filter added at the end:

iframe code example with the filter code added to the end of the URL.


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:

Scheduling page with arrow pointing at the 'Edit entry' button, highlighting to users where to click to open their entry settings.


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:

Locations page with arrow pointing at the 'Edit' button, highlighting to users where to click to open a specific location settings.

Copy the code from the URL in the search bar (in between the 'location' and 'edit' part of the URL):

Location screen example with arrow pointing at the part of the URL users need to copy for the unique location code. This sits 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:

Public page example showing schedule and arrow pointing at the 'View details' button, highlighting to users where they should click to open their event 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:

Public page example with arrow pointing at the code added at the end of the URL when users select 'View details'.

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:

Leader profile settings screen with arrow pointing at the URL, highlighting to users that the specific leader code is located at the end of the URL.

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:

Thank you! 🕺

Did this answer your question?