Skip to main content
Evaly provides a comprehensive test creation system that allows you to build structured assessments with multiple sections, flexible scheduling, and granular access control.

​
Creating a New Test

Tests are created as drafts by default, giving you time to configure all settings before publishing.
1

Create Test

Click “New Test” to create a blank test. Each test automatically includes one empty section to get you started.
2

Configure Basic Settings

Set your test title, description, and access level (public or private).
3

Add Sections and Questions

Organize your test into sections and add questions to each section.
4

Publish When Ready

Publish immediately or schedule for a specific time.

​
Test Configuration Options

​
Basic Settings

  • Title: The name of your test (required before publishing)
  • Description: Optional detailed description for participants
  • Access Level: Choose between public (anyone with link) or private (invited users only)

​
Scheduling Options

Evaly supports two scheduling modes:
Publish the test immediately. Participants can start taking it right away.
// Published with immediate start
isPublished: true
scheduledStartAt: Date.now()

​
Duration Control

Evaly offers two approaches to managing test duration:

Schedule-Based

Set an overall availability window with start and end times. Participants must complete the entire test within this window.

Section-Based

Set individual time limits for each section. The total test duration is the sum of all section durations.
When using section-based durations, all sections must have a duration set before publishing.

​
Question Randomization

Control how questions appear to reduce cheating:
  • Randomize Questions: Shuffle the order of questions within each section
  • Randomize Answers: Shuffle the order of answer choices for multiple-choice questions
// Enable randomization
randomizeQuestions: true
randomizeAnswers: true

​
Test Sections

Tests are organized into sections, allowing you to group related questions:
  • Section Title: Name for the section
  • Section Description: Optional instructions or context
  • Section Duration: Time limit for this section (when using section-based duration mode)
  • Section Order: Sections are presented in order - participants complete them sequentially
Participants must complete sections one at a time. They cannot skip ahead or go back to previous sections.

​
Publishing and Scheduling

​
Publishing Validation

Before publishing, Evaly validates:
  • Test has a title
  • All sections have questions (if not empty)
  • Section durations are set (if using section-based duration mode)
  • Section durations fit within test window (if both are configured)
  • Active tests limit is not exceeded

​
Active Tests Limit

Your subscription plan determines how many tests can be active simultaneously: 
// Free plan: 1 active test
// Pro plan: 10 active tests
// Enterprise: Unlimited
Active tests are those that are published and not yet finished. Scheduling overlapping tests counts against this limit.

​
Scheduled Test Activation

When you schedule a test:
  1. Test is marked as published immediately (can share link)
  2. Activation job is scheduled for the start time
  3. Finish job is scheduled for the end time (if set)
  4. Jobs are automatically cancelled if you reschedule or unpublish

​
Managing Active Tests

​
Pause and Resume

Pause a running test to freeze time for all participants: 
// Pauses test and cancels finish job
pausedAt: Date.now()

// Resume adds pause duration to scheduled end time
totalPausedDuration: 3600000 // 1 hour in ms
When you resume a paused test, the end time is automatically extended by the pause duration.

​
Extend Test Time

Add more time to a running test:
  • Add Minutes: Extend by a specific number of minutes
  • Set New End Time: Choose a new end time directly

​
Stop Test

Manually end a test before its scheduled end time:
  • Unpublishes the test
  • Cancels all scheduled jobs
  • Optionally marks the test as finished with a reason
  • Participants can no longer submit

​
Duplicating Tests

Create a copy of an existing test including all sections and questions: 
// Duplicates test structure
title: "Original Test (Copy)"
isPublished: false // Always starts as draft
// Scheduled jobs and timestamps are not copied
The duplicate includes:
  • All sections with their settings
  • All questions with options and settings
  • Test configuration (randomization, access level, etc.)
Duplicated tests do not inherit scheduling or publication status. You must configure and publish them separately.

​
Results Configuration

​
Release Results

Control when participants can view their results:
  • Release Immediately: Participants see results as soon as they finish
  • Release Later: Manually release results when you’re ready (default)
  • Toggle Anytime: Change this setting before, during, or after the test
resultsReleased: false // Hide results from participants
resultsReleased: true  // Show results to participants

​
Best Practices

  • Group related questions into sections
  • Use clear, descriptive section titles
  • Set realistic time limits based on question count
  • Test your timing with a practice run
  • For exams: Use schedule-based duration with fixed start and end times
  • For quizzes: Use section-based duration for timed sections
  • Always add buffer time for technical issues
  • Consider time zones when scheduling for distributed participants
  • Use private access for formal assessments
  • Use public access for practice tests and surveys
  • Share test links through secure channels
  • Monitor active participants during the test

​
Next Steps

Add Questions

Learn how to create questions with the rich text editor

AI Questions

Generate questions automatically with AI

Live Monitoring

Monitor participants in real-time during tests

View Analytics

Analyze test results and performance data

Build docs developers (and LLMs) love

Get started for freeTalk to us