10. Question Studio

Question Studio is the Web UI feature for authoring questions for Examinations and Questionnaires, bundling them into Question Books (exam / questionnaire), and publishing those books to the reader apps.

Note: Question Studio is available only to owner / admin accounts on one of the following plans:

• Team / Business / X-Platinum / X-Diamond
• Docomo d-team / d-business / d-enterprise
• Dedicated deployments

On Free / Personal plans the "Question Studio" entry in the header menu is hidden, and accessing the URL directly returns a plan_not_allowed error from the backend.

Note (difference from iOS/Mac): In the iOS/Mac version, question data was traditionally stored locally on the device. In the Web UI version the data lives on the server, so you can keep editing the same questions and question books from any browser. To reconcile questions authored locally on iOS/Mac with those authored in the Web UI, use 10.8 Sync with Client.

10.1 Screen Layout

Click "Question Studio" in the header menu to open the Question Studio screen. The URL is /question-studio/questions (etc.); the first visit is automatically redirected to the "Questions" tab.

Three tabs appear at the top of the screen.

Basic Workflow

1. Author questions in 10.2 Questions Tab. Questions are split into two categories: Examination and Questionnaire.
2. Create an exam / questionnaire book in 10.3 Question Books Tab and add questions to it in 10.5 Editing a Question Book.
3. 10.6 Publish the book so reader-app users can take it.
4. Check submissions in 10.7 Results Tab.

10.2 Questions Tab

The tab for authoring individual questions. Authored questions form a library and can be reused across multiple question books.

Clicking the Create button opens a menu of question types, split into two sections Examination and Questionnaire, with color-coded icons.

10.2.1 Toolbar (view mode)

In view mode the page-header right side shows:

The sub-header below shows a search box and a sort menu (updated / created / title).

10.2.2 Question List

Each row shows a colored icon for the question type and the title (start of the stem). The far right of each row has an edit icon that opens the 10.4 Question Editor.

10.2.3 Edit Mode (bulk actions)

Clicking Edit switches the list to edit mode. A checkbox appears on each row. Once at least one item is selected, the header toolbar changes to:

Tip: A "N selected" chip appears on the left of the toolbar; click the × to clear the selection.

10.2.4 Search & Sort

• Search: Matches partially against the question stem in real time. When nothing matches, "No question matches your keyword" is shown.
• Sort: Choose from "Updated · Newest first" (default), "Updated · Oldest first", "Created · Newest first", "Created · Oldest first", "Title · A → Z", or "Title · Z → A".

10.2.5 Import / Export

Note (file size): Both import and export are limited to 100 MB per file. Exceeding this yields a questionStudio_ie_error_tooLarge error.

Note (unsupported attachments): Attachments that do not pass the server's safety / MIME whitelist are silently skipped. A toast such as "Skipped K attachments because their format is unsupported" is shown.

10.3 Question Books Tab

This tab is where you bundle authored questions into an exam book or questionnaire book and prepare them for delivery to reader-app users.

When no books have been created yet, the tab shows an empty-state illustration with a Create Book button in the middle.

The Create button on the toolbar opens the following pop-up menu.

10.3.1 Toolbar (view mode)

The sub-header carries a search box and a sort menu (same as the Questions tab).

10.3.2 Book List (cards)

Each existing question book is displayed as a card containing:

10.3.3 Create Book Dialog

Choosing Create Exam Book or Create Questionnaire Book opens a dedicated dialog for each type.

Exam books have both Show Results and Show Correct Answers in Results toggles. Questionnaire books have only the "Only one response" toggle (no result-related toggles because there is no scoring).

Note: "Show Correct Answers in Results" (showCorrectAnswers) was newly introduced with the Web UI addition in June 2026. Existing books default to off.

10.3.4 Edit Mode (bulk actions)

Edit mode reveals checkboxes on each card. With at least one card selected you can use:

Note: While in edit mode the page title changes to "Edit Question Books". When one or more books are selected, an "N selected" chip appears in the middle of the toolbar and the Delete / Duplicate / Export / Publish buttons become enabled.

10.4 Question Editor

Open the question editor (/question-studio/questions/:id/edit) either by picking a question type from the Create menu on the Questions tab, or by clicking the edit icon on an existing question row.

For a questionnaire's Selective type, you can switch between Radio (single) / Dropdown / Checkbox (multi) and add options.

10.4.1 Common Layout

10.4.2 Question Categories

Question Studio has two categories:

• Examination: Questions with correct answers and scoring. Used inside exam books.
• Questionnaire: Questions without correct answers, used to collect responses. Used inside questionnaire books.

The Create menu groups its color-coded buttons by category.

10.4.3 Examination Question Types (6)

Fill in the Blank

• Insert ((1)), ((2)), ... numbered placeholders into the stem. The Add answer field button inserts one at the current caret position.
• Below the stem, each placeholder gets its own list of correct answers. You can register multiple accepted variants per blank.

Order

• Register items top-to-bottom in the correct order.
• Use Add item to add a row, the drag handle to reorder, or the red minus button to delete.
• At least 2 items are required (3+ enables partial-point scoring).

Point

• Use Add image to upload the answer image (movies are not supported here).
• Click on the image to place a pin. Pins are automatically labeled A, B, C, ...
• Each pin has an answer / tips field and a correct flag. Correct pins are displayed in green.

Connect

• Use Add paired answer to add pairs.
• Fill in the left and right text for each pair; one row is one correct pairing.

Select

• Enter text for each option and use Add correct answer option to add more.
• Check the checkbox on the right to mark at least one correct answer; multiple correct answers are allowed.

Picture Select

• Use Add picture to add image options. You can also attach an optional text label.
• Check the checkbox to mark each image as correct. At least 2 pictures and at least 1 correct picture are required.

10.4.4 Questionnaire Question Types (3)

Every questionnaire question has an "Answer required" toggle. When on, the respondent cannot submit without answering.

Selective sub-types

For Radio / Dropdown, the checkmark acts as the default selection, so you must check exactly one option (validated by selectiveErrSingleCorrect).

10.4.5 Saving

The Save button persists the question to the server. If validation fails, "Please fix issues before saving." is displayed and inline red messages appear.

10.5 Editing a Question Book (Book Detail)

Clicking a book on the Question Books tab, or selecting one in edit mode and clicking "Edit", opens the Book Detail view (/question-studio/books/:uuid/edit).

Newly created exam books start with no questions.

After adding questions, each row shows the number, type icon, stem, and point value.

Questionnaire books have a Start Questionnaire button instead of "Start Examination"; point value inputs are shown but disabled.

10.5.1 Screen Layout

10.5.2 Adding Questions (Add)

The Add button opens the Add Questions dialog with the library from 10.2 Questions Tab. Only examination questions can be added to exam books, and only questionnaire questions to questionnaire books.

Select one or more questions and click Save to append them to the book.

10.5.3 "Start Examination" / "Start Questionnaire" (Preview)

Clicking Start Examination or Start Questionnaire opens the same Question Player used by the reader app in a new page (/question-studio/books/:uuid/play) so you can preview exactly how the book will look.

• The rendering is identical to what reader-app users see.
• Preview submissions are not persisted (they do not show up in the Results tab).
• On exam books with Show Results enabled, a preview result page is shown after submit; if Show Correct Answers in Results is also on, correct answers appear alongside the responses.

10.5.4 Edit Mode

Click the Edit button (pencil icon) to enter edit mode:

• A checkbox appears on the left of each row so you can select multiple questions.
• A drag handle appears on the right so you can reorder questions.
• The Delete button removes the selected questions from this book (the questions themselves remain in the library).
• Points can be edited inline in each row.
• For question types that support partial-point scoring, Set Partial Points is available (see 10.5.5).

Click Done to save changes.

Note (version conflict): If another browser or admin updates the same book, "Another user updated this book. Reloading the latest version." appears and the latest version is loaded automatically.

10.5.5 Partial-Point Scoring

For Fill-in-the-Blank / Order / Connect / Point / Select / Picture Select questions that satisfy the threshold (2+ blanks, 3+ items, 2+ correct answers, etc.), Set Partial Points can be enabled from the row menu.

With partial points on, each answer element (blank / order slot / pair / pin / option / image) gets its own point value. The question total becomes the sum of these values (a mismatch causes a partialPointsSumMismatch error on save).

Scoring rules are the same as the iOS/Mac version:

• Fill-in-the-Blank / Order / Connect: Points for correctly answered elements are added up.
• Point / Select / Picture Select: Points are awarded only if the correct answers are selected exclusively. Selecting even one wrong item scores 0 for that question.

10.6 Publishing a Question Book

Select the target book(s) in edit mode on the Question Books tab and press Publish to publish the book to the reader apps.

• A confirmation dialog "Publish N selected book(s) to readers?" appears first.
• On success the revision number is incremented and the new version becomes available in the reader apps.
• Publishing fails when preconditions are unmet:
• Cannot publish: questions or cover are missing
• Cannot publish: storage quota exceeded
• Partial success is aggregated as "N published, K failed".

Note: Access to a published book is controlled the same way as other books — via sharing (Access Code, Group, User). See 4. Sharing for details.

10.7 Results Tab

The tab where you review and download responses to already-published question books.

10.7.1 Sub-tabs

Two sub-tabs are shown on the sub-header:

10.7.2 Result Table

Exam Books columns

Column	Description
Title	Book title (with cover icon)
Revision	Current version
Total Examinees	Total submitters
Average Point	Average score across all submitters
(Download)	icon at the row end opens the Download dialog

Questionnaire Books columns

Column	Description
Title	Book title
Revision	Current version
Number of Answers	Total respondents
(Download)	icon at the row end opens the Download dialog

The Update button on the toolbar refreshes the aggregation. Submissions from readers are reflected immediately without notable delay.

10.7.3 Downloading Results

Clicking the download icon opens the Download Result dialog.

Note (date range): Downloads are limited to the past year. Choosing an older From date shows a warning "Only data within the past year will be exported".

Note (no data): If there are no responses in the chosen range, a toast "No responses in the selected period" appears and no file is downloaded.

10.8 Sync with Client

On iOS / Mac, Question Studio stores questions locally on the device (with the user-personal backup uploading incremental changes to the server). The Sync with client (Backup Sync) feature reconciles those iOS/Mac backups with the questions authored in the Web UI, in both directions.

10.8.1 Launching

On the Questions tab, click Sync with client on the top right of the page header to open the preview dialog.

10.8.2 Preview Sections

The server computes the diff between the Web-side and iOS-side backup and groups items by section:

For each section:

• Each row has a checkbox for individual selection.
• "Select all in section" toggles the whole section.
• Conflict rows include a dropdown (Prefer iOS / Prefer Web / Skip) for resolution.

Note (uploads in progress): Questions with iOS uploads still in flight are automatically excluded, and a note "N items excluded because iOS uploads are in progress." is shown. Click Re-preview later to include them.

10.8.3 Applying

Once the selection is ready, click Apply.

• While running, a spinner "Syncing…" is displayed.
• On completion a summary "Success X / Skipped Y / Failed Z" is shown; a details section can be expanded.
• If data on either side changed between preview and apply, "Data changed after preview. Re-previewing." is shown; press Re-preview to retry.

10.8.4 Errors and Remedies

Note (iOS HEIC / HEIF / M4V): As of the July 2026 Web UI addition, iOS-specific image / movie formats (HEIC / HEIF / M4V) are on the server whitelist and can be ingested through Sync with Client.

10.9 Limitations & Troubleshooting

• Plans: As stated above, Question Studio is available only on Team / Business / X-Platinum / X-Diamond / Docomo (team/business/enterprise) / Dedicated. On other plans the menu entry is hidden.
• File size: Each attachment is capped at 100 MB. Import files are capped at 100 MB per file.
• Attachment formats: Movie support depends on the question type. Point questions accept images only.
• Skipped unsupported files: Dangerous files or files outside the server MIME whitelist are skipped automatically during import / export.
• Publish failure: "Missing questions or cover" / "Storage quota exceeded" prevent publishing. Verify the cover image and available storage.
• Version conflict: When the same book is open in multiple browsers, the later save fails and prompts you to reload the latest version. Editing from a single place is safer.
• Preview results: Submissions from the preview in 10.5.3 are not aggregated in 10.7 Results Tab. Only submissions from reader apps via shared access are counted.

← Previous: 9. Profile / Service Plan | Next: Appendix A. About Permissions →