If you are organising a video conference, webinar, or have a website where you wish to engage attendees, you can easily embed Pigeonhole Live Audience Web App onto the web page. This way, visitors to your website or online event can participate too.
We generate a HTML/JavaScript code that you can pass to your website team to integrate easily.
How to get embed code
In your Pigeonhole, click on More Settings> Integrations.
Scroll down to the Others section, and click Integrate on the "Embed Audience Web App" option.
You will see the following options in the pop-up:
| Option | Description |
| Session | You can choose a default session to appear on the page. Alternatively, if you select none, the Agenda page will be shown instead. |
| Width | The minimum width required is 320px. You can however customise it to a number larger than that. |
| Height | The minimum height required is 400px. You can however customise it to a number larger than that. |
| Redirect to latest ongoing session | When checked, this embed instance when first loaded will redirect attendees to the current ongoing session. |
| Hide session back button | When checked, this will prevent attendees from seeing the back button on the current session and navigating out of it. |
| Hide Pigeonhole exit button | When checked, this will prevent attendees from leaving the Pigeonhole’s Agenda page and seeing the passcode page. |
| Exclude from cast capture | When checked this will prevent the embedded session from redirecting to another session that is being cast. |
Once you specify your options, click on "Get embed code". A dialog will appear, with the exact code and instructions to send to your website team.
Note: By default, the hide session back button, exit button and exclude from cast capture will be checked by default - this default ensures that your attendees on an embedded session will be kept to that session (especially during hybrid events) within a specific web page.
Overriding the default settings on an embedded Audience Web App
If you wish to manually embed the Audience Web App on your website without using the generated code from the Dashboard, you can change the default settings (i.e. true) for the Exclude from cast capture, Hide session back button and Hide Pigeonhole exit button by overriding the defaults using the following query strings:
| Setting | Overriding Query String | Effect |
| Exclude from cast capture | keepWithinScope=false | The embedded Audience Web App will respond to any casting attempts that affect this session |
| Hide session back button | disableBackButton=false | The session’s back button will display for attendees to leave the session |
| Hide Pigeonhole exit button | disableExitButton=false | The Agenda will display the exit button and attendees can leave the Pigeonhole |
The example URL below uses the three overriding query strings to achieve the desired effects:
https://pigeonhole.at/PASSCODE/i/SESSIONID?keepWithinScope=false&disableBackButton=false&disableExitButton=false
Note: The PASSCODE and SESSIONID variables above should be replaced with your own relevant Passcode and SessionID.
Multiple embeds on the same web page
You can embed multiple Pigeonhole Live Audience Web App on the same web page. You could specify different sessions within the same Pigeonhole, or even from another Pigeonhole. For the required code, please send us a support ticket, and we'll advise on the code.
Special attention to your Pigeonhole participant limit
Your embed participant limit will be determined by the participant limit in your Pigeonhole plan.
Note: We highly recommend that you enable Registrant Profiles if you wish to ensure that attendees who rejoin the Pigeonhole are not double-counted towards the Participant Limit. Attendees can still choose to submit responses anonymously (like in a Q&A) while having a profile. So attendees can still be given the option of voicing out their true thoughts and concerns anonymously while preventing multiple sign-ins from the same user from bloating the participant count.
Each web page hit might lead to a unique participant being registered on our backend. If the participant logins reach the limit in your Pigeonhole plan, new loads will return a "Maximum participant limit reached" error.
For more information on participant counts, refer here.