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 2 weeks ago

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:

  1. Open your public page.

  2. 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.

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:

  1. Copy and paste the iframe code into your website.

  2. Add a filter to the URL part of the code (e.g. https://bookwhen.com/demo-website/iframe)

  3. For example, to show events starting from 1st September 2024, add ?start=2024-09-01 to the end of the URL:

4. Replace the iframe code with your new filtered URL:

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


Entry Filters

To display a specific event in your iframe, you’ll need its unique entry code.

How to find the entry code

  1. Open your scheduling page, select the event you want to filter, then Edit entry:

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

  2. The code is in the URL bar at the top. For example https://admin.bookwhen.com/entries/extumtzw7jg8/edit :

    Edit entry screen with arrow pointing at the 'extumtzw7jg8' section of the entry URL

  3. 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

  1. 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


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

  1. 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

  1. Select Settings from the left-hand menu on your account, then Locations.

  2. 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.

  3. 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.

  4. 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

  1. Open your public page, select the event, then View details:

    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.

  2. 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:

iframe code example with the URL extension highlighted


Team member filters

Filtering by specific team members helps customers find events led by their Leaders.

To do this:

  1. Select Account on the left-hand menu on your account, then Team.

  2. Select the pencil and paper icon 📝 next to the leader to open their profile settings.

  3. 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.

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! 🕺

Did this answer your question?