In this video we explain how to set-up and customize an online workshop on your platform. You’ll learn how to tailor the workshop functionality, hold live video meetings, and set up breakout groups to facilitate simultaneous group discussions.
​
Key words: timeline set-up, dote voting, grouping inputs, break-out sessions.

Below you'll find step-by-step description that guides you through the main steps of setting up your very own online workshops.

To access your workshops, first log into your platform as an administrator or project moderator. In your admin panel, there is a "Workshops" tab where you can access your workshop interface, in this tab click on 'Manage your workshops' to enter this interface.

In the workshop interface, you will see the option to add a new workshop. Clicking on this button will prompt you to pick a name and date for your workshop.

The slug defines the url where participants will find your workshop. E.g. if your slug is 'climatepolicy', the link to the workshop will be 'yourplatform.citizenlab.co/workshops/climatepolicy'.

You can manage the different steps and activities of your workshop through the "Manage" button on the top right corner of the workshop screen. Once you've entered the admin panel, click on +Add step to specify the different steps that you would like to have in your workshop. Commonly, this includes a "Welcome" step at the beginning, a "Conclusion" step at the end, and a few steps in between for discussion and break-out rooms.

You can add as many rooms as you would like for your workshop by clicking on the +Add room button in the admin panel and giving the room a name.

There are two types of rooms: a main plenary room, where all of the participants are together, and smaller break-out rooms, which the participants will sort themselves into for more interactive discussion. As a rule of thumb, one break-out room for every 5-8 participants seems to work well.

Each time you add a new room, you will be asked to configure the video chat settings.

You cannot disable these settings for platform administrators and project managers. They will always have access to all of these (and more) options, regardless of the room configuration.

During this step, you need to define what needs to happen in each room during each step - we call this a "roomstep." You can do this by hovering at the intersection between the step and the room that you want to configure and clicking +Add roomstep.

When you add a roomstep, you have a number of participation methods to choose from. Each of these participation methods affects the interaction on the right side of the screen. The video is always visible on the left side of the screen, no matter what participation method you choose.

Below, we discuss in more detail what each of these participation methods entails:

With this method, you can ask your participants one or more questions. You can then give participants the option to "post" (i.e., write their responses onto a digital post-it note) and/or "vote" (i.e., upvote posts). The maximum length of written answers is 255 characters, and you can choose for the posts to either be configured as square cards or as rectangular cards that are displayed in a list format.

You could also break this into two separate steps: in one step, you could ask participants to post their responses, and in the next step, ask participants to vote on the responses they agree with most.

Tip: Select 'Copy Q&A inputs from previous step' if you want participants' answers of the previous step to remain visible in the current step as well.

This method is good for information-oriented steps. You can share written information using the "Info text" text box. The info text box here (and in other steps) can be configured with basic text formatting options, including bulletpoints.
​

This step can also be used if you'd like to give a presentation. The share screen option allows you to broadcast a presentation or other media from your computer to other workshop participants.

Tip: use the "Full screen for all participants" button on the top left of the video screen to make all workshop participants go into full screen mode. If you combine this with sharing your screen, they will have a much better view of whatever document you are displaying.
​
​

Breakout rooms

Want to have smaller group discussions? No problem. Use the "breakout rooms" participation method to create a lobby - it will prompt all of the participants to join a smaller break out room (these are the additional rooms that you added in Step 3: Define your rooms).
​
You can choose two options for breakout rooms:
- Self-selection: Allow participants to self-select which breakout room they will join
- Random assignment: Randomly distribute participants into a breakout room
​

To randomly assign participants to a breakout room, select the Random Assignment method. Once you have entered into the breakout room step, any workshop admin can click the button "Distribute participants to breakout rooms." This will evenly assign participants into the different rooms. Workshop admin will remain in the lobby and can join whichever room they choose.

Don't forget! You will need to configure each of the smaller break out rooms with their own participation method.

Do you have several break-out rooms that require the same configuration in a given step? Create the first room with the settings and questions that you'd like, and for the other rooms, check the box to 'Share the configuration' of the first room - it will automatically copy that configuration, including the info and the questions. When you make changes to the configuration of one room, it will update all other rooms sharing the same configuration. This can be a real time saver.

These 2 methods are parts of the same conclusion flow. Use the 'Summarise discussion' method in the last step where people are in smaller break-out rooms. This generates a text box that allows you to collaboratively draft a group conclusion (Note: anyone can type in and edit the text in this box. To edit the text, click the "edit text field" box above the text field - to allow someone else to edit the text, just uncheck the box.)

If you want to share these smaller break-out room conclusions with all of the participants, you can use the 'Report out' method in the next step, combined with bringing people back to the main plenary room.

This would be similar to bringing everyone back together from small groups to share what they had discussed in an "in-person" workshop. In the 'Report out' step, the discussion summaries that were generated in the breakout rooms are automatically shown for everyone to see.

You can now easily run through your workshop, test things out and check if everything is set up the way you envisioned.

You can advance steps by clicking on the "Next step" button on the top right of the screen. You can choose to immediately advance to the next step, or select a timer that lets everyone know that the next step will start in 10 seconds, one minute or five minutes.

If you want to go back and check one of the steps, open the 'Manage' interface, and click 'Go to step' on the step that you want to go to.

Decided that you want to change the order of the steps? No problem. You can move steps between each another in the Admin Panel using the Reorder Steps button. Click on the icon, change the order of the steps, and click on the icon again to save the new order.

To end the workshop, click on 'End workshop for all' on the top right-hand side of the screen, which leads all participants to an exit page where they can provide some feedback.

Note: When testing, don't add written input yourself. We currently don't have an easy way of erasing that test input later on. So you would need to completely redo that roomstep configuration in order to get rid of it!

When you are done with setting up your workshop you can share the link of the workshop with the participants. The URL of the workshop is the way to access the workshop.

Simply copy the URL and (e.g. 'yourplatform.citizenlab.co/workshops/climatepolicy') and paste it in your message or put it behind a button in a project on your platform.

When you're done with the workshop, you can export all of the input that was provided through the polls, the Q&A cards, and the input conclusions step. In the admin panel, you'll find an icon at the top labeled "Export Data." It will automatically download an Excel spreadsheet with this information - one tab for each step in your workshop.

If you or your participants are having difficulty getting your audio or video to work, below are a few basic troubleshooting options:

Workshop capacity: The workshops support up to 50 participants. If you have many participants, the speed and quality of the video may degrade. You can help to prevent this by setting people's cameras to be 'off' by default when they enter a room. If 50 people are already in the room, no one else will be allowed in.

Access and browsers:

Adding an image into an info box: You can also add an image in the text box by inputting a URL where the image is hosted. The image needs to be hosted by a provider such as www.postimage.org - make sure to use the direct link and copy/paste it into the text field.

Admin rights: Anyone who is signed into the CitizenLab platform as an Admin or a Project Manager can be granted Admin rights in the workshop. This means they can manage the workshop, add/edit steps, advance the steps and end the workshop.
​
​Important: The first Admin or Project Manager who enters the workshop room is assigned 'superadmin' rights. By clicking on the three dots on the top right of any other Admin or Project Manager's video screen, you can grant them Moderator rights as well. This will allow them to mute and kick out participants.