Skip to main content

​
Get started in five steps

This guide will walk you through creating your first test on Evaly, from account setup to publishing your first assessment.
1

Create your account

Sign up for Evaly using Google OAuth authentication.
  1. Navigate to the Evaly platform
  2. Click Sign in with Google
  3. Authorize the application
Evaly uses Convex Auth for secure authentication. Your credentials are never stored directly.
2

Set up your organization

During onboarding, you’ll create or join an organization.Creating a new organization:
  • Choose an organization name
  • Select your organization type (Education, Corporate, etc.)
  • Set your display name
Joining an existing organization:
  • Use an invitation link from your administrator
  • Accept the invitation to join the team
Organizations allow you to collaborate with team members and manage tests collectively.
3

Create your first test

From the dashboard, create a new test:
  1. Click Create Test in the sidebar
  2. Give your test a title (e.g., “Mathematics Quiz”)
  3. Add a description (optional)
  4. Configure basic settings:
    • Access type: Public or Private
    • Publishing status: Draft (default)
// Test is created with default settings
{
  title: "Mathematics Quiz",
  description: "Weekly assessment for Chapter 5",
  access: "private",
  isPublished: false,
  organizationId: "your-org-id"
}
Start with a draft test. You can publish it later after adding questions.
4

Add questions

Build your test by adding sections and questions:

​
Create a section

Tests are organized into sections for better structure:
  1. Navigate to the Questions tab
  2. The default section is created automatically
  3. Click to rename it (e.g., “Algebra Questions”)
  4. Set a duration if needed (optional)

​
Add questions

Choose from 13+ question types:
Create questions with multiple options (single or multi-select):
  • Write your question text
  • Add options (minimum 2)
  • Mark correct answers
  • Assign points (default: 1)
  • Enable Allow multiple answers for checkbox-style questions
Short or long-form text responses:
  • Set character limits (min/max)
  • Add placeholder text
  • Requires manual grading
Visual questions with image options:
  • Upload images for each option
  • Mark correct answers
  • Great for diagrams, logos, or visual identification
Allow students to submit documents:
  • Accepts various file types
  • Size limits based on your plan (10MB-100MB)
  • Useful for assignments and projects
See the full list of question types including audio responses, video responses, ranking, Likert scales, and more.

​
Use AI to generate questions

Save time with AI-powered question generation:
  1. Go to Question Library
  2. Click Generate with AI
  3. Describe your topic and requirements
  4. Review and edit generated questions
  5. Add to your test
// AI generates questions based on your prompt
"Create 5 multiple-choice questions about photosynthesis
for high school students, medium difficulty"
AI question generation uses monthly quotas based on your plan (Free: 10/month, Pro: 250/month).
5

Configure and publish

Before publishing, configure your test settings:

​
Access control

  • Password protection: Require a password to access
  • Email restrictions: Limit by email domain (@school.edu)
  • IP whitelisting: Restrict by IP addresses
  • Participant lists: Add specific participants or groups

​
Scheduling

Set automatic activation:
{
  scheduledStartAt: 1709136000000, // March 1, 2024 9:00 AM
  scheduledEndAt: 1709143200000    // March 1, 2024 11:00 AM
}
  • Tests activate automatically at the scheduled time
  • Automatic deactivation at end time
  • Background jobs handle timing

​
Duration settings

Choose between:
  • Test-level duration: One time limit for entire test
  • Section-level durations: Different time limits per section

​
Results visibility

Control when students see results:
  • Release immediately after submission
  • Release manually after grading
  • Hide detailed results (show score only)

​
Publish your test

When ready:
  1. Click Settings tab
  2. Toggle Published to ON
  3. Share the test link with participants
Get a shareable QR code from the Share tab for easy distribution.

​
Monitor your test

Once participants start taking your test:

​
Real-time monitoring

Track live activity from the Monitor tab:
  • Active participants (presence tracking)
  • Completion progress by section
  • Answer submissions in real-time
  • Connection status monitoring
// Real-time presence updates via Convex subscriptions
const presence = useQuery(api.organizer.testMonitoring.getTestPresence, {
  testId: test._id
});

​
View results

Access comprehensive analytics from the Results tab:
  • Individual participant performance
  • Question-level statistics
  • Score distribution charts
  • Time tracking analysis
  • Export results to CSV

Grade manually

Review and grade subjective questions

Analytics

Explore detailed performance insights

​
Next steps

Question library

Build reusable question banks

User groups

Organize participants into groups

Test settings

Configure advanced options

Access control

Secure your assessments

​
Common questions

Yes, you can edit test settings, add questions, and modify existing questions even after publishing. However, changes may affect participants currently taking the test.
Avoid making major changes while participants are actively taking the test.
You can add participants in several ways:
  • Add individual emails in the Access tab
  • Bulk upload emails (comma or newline separated)
  • Assign user groups
  • Use public access for open tests
Scheduled tests use background jobs:
  • Tests automatically publish at scheduledStartAt
  • Tests automatically deactivate at scheduledEndAt
  • Job IDs are stored for cancellation if you change the schedule
  • Participants cannot access before start time
Yes, with auto-save functionality:
  • Answers are saved automatically as students work
  • Students can close the browser and return later
  • Progress is preserved across sessions
  • Section timers continue counting unless test is paused by educator
Need help? Check out the detailed guides for educators or explore all features.

Build docs developers (and LLMs) love

Get started for freeTalk to us