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
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
 |
3b. Admin - Manage Events - View Event - Manage Presenters
You can invite others as Presenters to help you manage your event. Any added Presenter will be able to pin/unpin questions, mark questions as answered and delete any questions.
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
|
 |
 |
3c. 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.
 |
3d. Admin - Manage Events - Delete 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.
 |
Presentation Mode
 |
 |
Present - Pin
 |
 |
Present - Mark As Answered
 |
Attendee - Join Event
 |
Ask Question
 |
Like Question
 |
Delete Question
 |
That's it, all done! You are now ready to start using TownHall.