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.
| Mode | In short |
|---|---|
| Identified | Answers 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 creator | Nobody 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 anonymous | Nothing identifying is stored with answers: not a name, not an account, not a integrated-platform identity. |
Full detail: Privacy modes.
Other terms
| Term | Meaning |
|---|---|
| Join code | The six-digit number participants type to join a session. It is retired when the session closes. |
| Phase | Where a live session is with the current question: waiting, accepting answers, closed, showing results, showing the answer, or showing the leaderboard. |
| Reveal | Showing the correct answer of a scored question. Before the reveal, phones are not sent the answer at all. |
| Leaderboard | A ranking of participants (identified sessions only) or teams (quiz team mode). |
| Board | A Q&A or brainstorm question, where participants post and upvote many contributions rather than giving one answer. |
| Moderation | Reviewing board posts before the room sees them. On by default for Q&A. |
| Integration | A integrated platform or other external system registered in a workspace, which launches people into activities and receives their outcomes. See Integration. |
| API key | A credential for the public REST API, belonging to a workspace, with explicit scopes. |
| Webhook | An HTTPS address Murmle sends signed event notifications to. |