Skip to main content

Core concepts and glossary

Murmle uses a small set of words consistently, in the product and in these docs.

The building blocks​

Workspace
Activity (poll, quiz, survey or Q&A)
Version 1 (published, frozen)
Version 2 (published, frozen)
Version 3 (draft, being edited)
Questions and content slides, in order
Sessions (each one a run of one published version)
Participants
Answers

Workspace​

The organisation's space in Murmle. Activities, sessions, results, integrations and the audit log all belong to exactly one workspace, and nothing is visible across workspaces. A person who creates their account by signing in gets a personal workspace of their own; an organisation workspace holds a team's shared work. People are members of a workspace and hold one or more roles in it.

Activity​

What a creator builds: a sequence of questions and content slides. An activity has a kind - poll, quiz, survey or Q&A - which decides the editor's defaults and which question types it offers first. It does not limit what you can add: a poll can contain a rating question.

Version​

Activities are versioned. You edit a draft; publishing freezes it. Editing a published activity starts a new draft, so a session that has already run keeps the exact questions its participants answered. See Publishing and versions.

Question (interaction)​

One step in an activity that collects an answer: a multiple choice question, a word cloud, a ranking, a Q&A board and so on. The product calls all of them questions. The API and the integration contract call them interactions, because a Q&A board or a word cloud is not really a question - the two words mean the same thing. A content slide is a step that collects nothing: a heading, bullets, an image, a video, a quote or a big number.

Session (run)​

One run of one published version of an activity, with its own join code, participants and results. A session is either live - the presenter moves everyone through the questions together - or self-paced, where each participant works through the activity on their own.

Participant​

A person answering in a session. Participants do not need a Murmle account and are not members of the workspace. What Murmle stores about a participant depends on the session's privacy mode.

Creator​

The person who builds an activity. In role terms, someone with the creator, admin or owner role.

Presenter​

The person running a live session from the presenter view: opening and closing voting, revealing results and answers, moving to the next question. Anyone with the presenter, creator, admin or owner role can present.

Privacy modes​

Every activity has one of three privacy modes. Each is a different storage shape, enforced when answers are written, not hidden when they are shown.

ModeIn short
IdentifiedAnswers are recorded against the participant's name. Required for contact-details questions, manual team assignment and outcome reporting to an integrated platform.
Anonymous to the creatorNobody in the workspace can see who gave which answer. Murmle keeps a one-way code only to stop the same person answering twice. The default for polls, surveys and Q&A.
Fully anonymousNothing identifying is stored with answers: not a name, not an account, not a integrated-platform identity.

Full detail: Privacy modes.

Other terms​

TermMeaning
Join codeThe six-digit number participants type to join a session. It is retired when the session closes.
PhaseWhere a live session is with the current question: waiting, accepting answers, closed, showing results, showing the answer, or showing the leaderboard.
RevealShowing the correct answer of a scored question. Before the reveal, phones are not sent the answer at all.
LeaderboardA ranking of participants (identified sessions only) or teams (quiz team mode).
BoardA Q&A or brainstorm question, where participants post and upvote many contributions rather than giving one answer.
ModerationReviewing board posts before the room sees them. On by default for Q&A.
IntegrationA integrated platform or other external system registered in a workspace, which launches people into activities and receives their outcomes. See Integration.
API keyA credential for the public REST API, belonging to a workspace, with explicit scopes.
WebhookAn HTTPS address Murmle sends signed event notifications to.