Skip to main content
Evaly’s question editor provides a comprehensive set of tools for creating rich, interactive test questions with support for multiple question types, media attachments, and advanced formatting.

​
Supported Question Types

Evaly supports 13 different question types to suit any assessment need:

Multiple Choice

Traditional multiple choice with single or multiple correct answers. Supports text, images, and audio options.

Yes/No

Simple binary choice questions with pre-configured Yes and No options.

Image Choice

Multiple choice with image options. Each option can have an image and optional text label.

Audio Choice

Multiple choice with audio options. Each option can have an audio file and optional text label.

Text Field

Open-ended text input for short answers or essay responses.

File Upload

Allow participants to upload files as their answer (documents, images, etc.).

Fill the Blank

Cloze-style questions where participants fill in missing words or phrases.

Audio Response

Participants record audio as their answer.

Video Response

Participants record video as their answer.

Matching Pairs

Match items from two columns or lists.

Slider Scale

Numeric scale input with customizable range.

Likert Scale

Agreement scale (Strongly Disagree to Strongly Agree).

Ranking

Order items by preference or priority.

​
Creating Questions

1

Add Question

Click “Add Question” in a test section and select the question type.
2

Write Question Text

Use the rich text editor to write your question with formatting and media.
3

Configure Options

Set up answer choices, correct answers, and question-specific settings.
4

Set Point Value

Assign points (when using point-based scoring).

​
Question Settings

​
Multiple Answers

For multiple-choice questions, you can allow participants to select multiple correct answers: 
allowMultipleAnswers: true // Checkbox-style selection
allowMultipleAnswers: false // Radio button selection (default)

​
Answer Options

Each option in a multiple-choice question includes:
  • Text: The option text (rich text supported)
  • Is Correct: Mark as correct answer
  • Media URL: Optional image or audio file
  • Point Value: Custom points for partial credit (advanced)
options: [
  {
    id: "abc123",
    text: "Option text",
    isCorrect: true,
    mediaUrl: "https://cdn.example.com/image.jpg",
    mediaType: "image",
    pointValue: 1
  }
]

​
Point Values

When a section uses point-based scoring, you can assign custom point values:
  • Per Question: Set total points for the question
  • Per Option: Set points for each option (for partial credit)
In percentage mode, all questions are worth 1 point. In point-based mode, you can customize point values.

​
Question Ordering

Questions within a section have an order field that determines their sequence:
  • Drag and drop to reorder questions
  • Order is preserved when duplicating tests
  • Randomization (if enabled) shuffles this order for each participant
order: 1 // First question in section
order: 2 // Second question
// etc.

​
Media Support

​
Adding Images

  • Upload images for question text or answer options
  • Supported formats: JPG, PNG, GIF, WebP
  • Files stored in Cloudflare R2 with CDN delivery

​
Adding Audio

  • Upload audio files for listening comprehension questions
  • Supported formats: MP3, WAV, M4A
  • Audio players embedded in question interface

​
File Storage

All media files are:
  • Uploaded to Cloudflare R2 storage
  • Served via CDN for fast delivery
  • Automatically cleaned up when deleted
  • Accessible via public URLs

​
Question Grading

​
Auto-Grading

The following question types are automatically graded:
  • Multiple Choice (single and multiple answer)
  • Yes/No
  • Image Choice
  • Audio Choice
  • Matching Pairs (when configured with correct pairs)
  • Slider Scale (when configured with correct value)

​
Manual Grading Required

These question types require manual grading:
  • Text Field
  • File Upload
  • Fill the Blank (unless exact match configured)
  • Audio Response
  • Video Response
  • Likert Scale (usually no wrong answer)
  • Ranking (unless specific order configured)
Questions requiring manual grading are marked as “Needs Review” and won’t have final scores until you grade them.

​
Regrade Protection

When you modify answer options or correct answers after participants have submitted:
  1. Evaly detects existing grades that would be affected
  2. Shows a confirmation dialog with the number of affected submissions
  3. Offers to automatically regrade all affected answers
  4. Updates all grades if you confirm
// Regrading is triggered when:
- Changing which options are marked correct
- Adding or removing options
- Modifying option media or text significantly

// You can force regrade or skip it
forceRegrade: true // Regrade all submissions
forceRegrade: false // Keep existing grades (not recommended)
Always regrade when changing correct answers to ensure fair scoring.

​
Question Libraries

Reuse questions across multiple tests:

​
Creating Library Questions

  • Create standalone questions in your question library
  • Tag and organize by subject, difficulty, or topic
  • Search and filter when adding to tests

​
Duplicating Questions

When adding a library question to a test: 
referenceId: "section_xyz" // Current section
originalReferenceId: "library_abc" // Source library
// Question is copied, not linked
// Edits don't affect original library question

​
Advanced Settings

​
Question-Specific Settings

Each question type has specialized settings:
  • Character limit
  • Minimum length requirement
  • Placeholder text
  • Rich text formatting enabled/disabled

​
Best Practices

  • Use clear, unambiguous language
  • Avoid double negatives
  • Keep questions focused on a single concept
  • Provide adequate context
  • Use formatting to highlight key information
  • Provide 4-5 options for multiple choice
  • Make distractors plausible but clearly incorrect
  • Avoid “all of the above” or “none of the above”
  • Keep option length similar
  • Randomize answer order to prevent patterns
  • Optimize images to reduce file size
  • Ensure audio is clear and high quality
  • Provide alt text for accessibility
  • Test media playback before publishing
  • Weight questions by difficulty or importance
  • Keep point values round numbers (1, 2, 5, 10)
  • Clearly communicate point values to participants
  • Use consistent point values for similar questions

​
Next Steps

AI Question Generation

Generate questions automatically using AI

Manual Grading

Learn how to grade open-ended questions

Test Creation

Go back to test creation overview

Analytics

Analyze question performance and difficulty

Build docs developers (and LLMs) love

Get started for freeTalk to us