Getting started with TownHall is easy. Just follow these simple steps and you are on your way!
Install TownHall
Tips
TownHall can only be installed with System Admin access
TownHall is only available on Confluence Cloud, and not supported on Confluence Server and Data Center
Open the Atlassian Marketplace web page
Search for TownHall in the "Search for apps" search bar
Select TownHall - Live Q&A for Confluence Cloud from the search results
Select "Get it now" button for the Free app
Select your hosting type as "Cloud" and install the app
About TownHall
TownHall is a Confluence Cloud app to create and manage events and audience questions.
The three main users within TownHall are Admin, Presenter and Attendee.
Admin
As an Admin, you can create an event by entering the event name, event code and event timeline. You can also manage events by editing event settings, adding a Presenter to the event, sharing the event code with Attendees, and deleting the event. Within an event, you can manage event questions by pinning or unpinning a question, marking a question as answered, reopening an answered question, and deleting a question. And finally, you can view the event as a Presenter or as an Attendee.
Presenter
As a Presenter, you can present an event in a special full screen Presentation mode, where you can pin a question being answered, and also mark a question as answered once it has been responded to.
Attendee
As an Attendee, you can join an event with an event code, and within the event, ask questions, upvote questions, and also delete questions that you have previously asked.
Use TownHall
1. Home page
Open your Confluence Cloud site home page
Select Apps → TownHall from the menu bar
View TownHall home page
 |
2. Admin - Create Event
Any user who creates an event will be assigned the role of Admin for the event.
Click the "Create Event" button on the TownHall home page
You will be shown a "Create Event" pop up page to create a new event
Enter your event name, event code, event state date and event end date
Click the "Create" button
Your event will now be created
 |
 |
3. Admin - Manage Events
Click the "Manage Events" button on the TownHall home page
You will be shown the Manage Events page with a list of all the Active Events and Past Events
 |
3a. Admin - Manage Events - View Event
Select an event on the Manage Events page
You will be shown the View Event page with a list of Open Questions and Answered Questions
 |
3e. Admin - Manage Events - View Event - Manage Presenters
Only Admins can Add Presenters to help them manage the event.
Click the "Settings" button on the View Event page
Select the "Manage Presenters" setting
You will be shown the "Manage Presenters" pop up page to add a presenter to the event
Select a name from the drop down list and click on "Add as Presenter" button
The presenter will be added to the Current Presenters list
|
 |
 |
3f. Admin - Manage Events - View Event - Share Event
Click the "Settings" button on the View Event page
Select the "Share Event" setting
You will be shown the "Copied to clipboard!" pop up message. You can share this event code via online messaging, calendar invite, or email to the Attendees.
 |
3g. Admin - Manage Events - View Event - Delete Event
Only Admins can Delete Events.
Click the three dots menu for an event on the View Event page
Select the "Delete Event" option
You will be shown the "Delete Event” confirmation pop up message - “Would you like to permanently delete this event? All the event data will be lost. This cannot be undone.”
Select “Delete” button
Your event will now be deleted
 |
 |
4. Presenter - Manage Events - View Event - Present Event
Presenters can also Pin/Unpin Questions, Mark Questions as Answered/Reopen Questions and Delete questions (similar to Admin).
Click the "Present" button on the View Event page
You will be shown the "Presentation Mode" which is a special fullscreen view of the event questions which can be used during live Q&A sessions
In the Presentation Mode, you can sort event questions by “Most Liked” or “Most Recent”
 |
 |
4a. Presenter - Manage Events - View Event - Present Event - Pin Question
 |
 |
4b. Presenter - Manage Events - View Event - Present Event - Mark Question as Answered
 |
5. Attendee - Join Event
 |
5a. Attendee - View Event - Ask Question
 |
5b. Attendee - View Event - Upvote Question
 |
5a. Attendee - View Event - Delete Question
 |
 |