Practice Makes Perfect
We highly recommend setting up a test event and playing it on a Display ahead of your Town Hall to ensure your event looks and behaves exactly the way you’re expecting.
Set Up Your Teams Town Hall
Requirements
To run a Town hall live event, you need a qualifying license (or a Town Hall add-on/replacement):
Microsoft 365 / Office 365 Enterprise E1, E3, or E5
Microsoft 365 / Office 365 Education A3 or A5
If your organization uses a Microsoft 365 Business plan (like Business Basic, Standard, or Premium), your license does not include the Live Event feature by default, and this is the most frequent reason the option is missing.
Create a Town Hall in Microsoft Teams
You need to make sure that your event is set to Public. This setup is designed for one-to-many streaming where attendees are view-only and don't need to interact.
Create the Town Hall
Open your Teams Calendar.
Select the dropdown arrow next to New meeting (or + New event) and choose Town hall.
Fill out the Details (Title, Date, Time, Description).
Crucially, look for Event access (or similar wording, which may be under Event details).
Set the access type to Public.
Note: The wording may be "Public" or "Everyone" in some contexts. This setting allows anyone with the link to join without signing in.
Configure the Attendee Experience
When you set the event access to Public, attendees (including your digital signage) will have a restricted, view-only experience by default, which meets your requirements, meaning they do not need a Teams account to access and microphone and camera access will be bypassed.
Click Meeting Options
In the Meeting Access tab, choose People dialing in can bypass the lobby
Get the Embed Video URL
After you save and publish the Town Hall:
Go back to the Town Hall event in your Teams Calendar.
Open the event details.
Look for a Join event or Attendee link section.
Copy the text from the Video Embed URL field.
Create Your Code Bundle
Create Your HTML File
In the text editor of your choice (such as Visual Studio Code, Sublime Text, Notepad++, etc.)
<!DOCTYPE html>
<html lang="en" class="h-full">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Teams Town Hall Fullscreen</title>
<!-- Load Tailwind CSS -->
<script src="https://cdn.tailwindcss.com"></script>
<style>
/* Ensure the body and HTML elements fill the viewport */
html, body {
margin: 0;
padding: 0;
overflow: hidden; /* Hide scrollbars if any are generated */
}
</style>
</head>
<body class="bg-gray-900 flex items-center justify-center h-full">
<!--
REPLACE WITH EVENT IFRAME
-->
<iframe
src="https://teams.microsoft.com/convene/townhall?eventId=93ba88ae-308e-4d4d-9fab-8c98dbe4463e@0e1fba17-955d-4691-b4b1-cf7a7193c0bf&sessionId=c4e6628f-927f-4040-b7da-c1b854174889"
frameborder="0"
scrolling="no"
allowfullscreen
style="border:none;"
allow="autoplay; camera; microphone"
class="w-screen h-screen"
></iframe>
<!--
REPLACE WITH EVENT IFRAME
-->
</body>
</html>Then replace the section beginning with <iframe and ending with ></iframe> with the text you copied from Teams.
Then save as an HTML file.
Optimizing Your Settings
Your embedded video data might have different settings from above, such as a specific height and width. For the best performance on a Skykit device, we recommend using the settings above:
frameborder="0"
scrolling="no"
allowfullscreen
style="border:none;"
allow="autoplay; camera; microphone"
class="w-screen h-screen"
Zip Your HTML File
You must then zip your HTML file to create a code bundle.
On a Windows PC:
Locate the HTML file in File Exporer
Select your file
Right click on the selected item
Send to
Compressed (zipped) folder
On a Mac:
Locate the HTML file in Finder
Select your file
Right click on the selected item
Compress
Upload and Play Your Code Bundle
Now you’re ready to Upload Your Code Bundle to Beam and play it on a Display.
Setting Content Temporarily as a Task
You can use an Override Media Task to change content on your Displays to play your Town Hall for a set amount of time, then revert back to what they were playing previously.