Skip to main content

​
Overview

Knowledge Checks are the core of KnowledgeCheckr. They are comprehensive assessments that you can create, customize, and share with your team or publicly. Each knowledge check combines questions, settings, and categories to deliver a tailored learning experience.
A knowledge check can contain multiple question types, each assigned to specific categories with configurable difficulty levels.

​
Knowledge Check Structure

Every knowledge check consists of:

Questions

A collection of questions in various formats (single-choice, multiple-choice, drag-drop, open-ended)

Categories

Organizational groups for questions with optional prerequisites

Settings

Configure practice mode, examination mode, timing, and access controls

Metadata

Name, description, difficulty level, and ownership information

​
Creating a Knowledge Check

When you create a new knowledge check, you’ll configure:

​
Basic Information

  • Name: A descriptive title for your assessment
  • Description: A brief explanation of what the check covers
  • Difficulty: A rating from 1-10 indicating the skill level required
  • Owner: The creator and primary administrator
  • Collaborators: Additional users who can edit the check

​
Availability Windows

Set when users can first access the knowledge check. This determines the earliest date users can begin practicing or taking examinations.
openDate: Date // When the check becomes available
The close date must be after the open date. If no close date is specified, the knowledge check remains available indefinitely.

​
Example Configuration

Here’s what a complete knowledge check looks like: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "JavaScript Fundamentals",
  "description": "Test your knowledge of core JavaScript concepts",
  "difficulty": 5,
  "openDate": "2026-03-01T00:00:00Z",
  "closeDate": null,
  "owner_id": "user-123",
  "collaborators": ["user-456", "user-789"],
  "questions": [...],
  "questionCategories": [...],
  "settings": {...}
}

​
Sharing Your Knowledge Check

KnowledgeCheckr provides flexible sharing options:
Enable shareAccessibility in settings to make your check discoverable by all users. When enabled, anyone can find and access your knowledge check.
settings: {
  shareAccessibility: true
}
Generate a unique share key to provide direct access to specific users or groups. This allows private sharing without making the check publicly discoverable.
share_key: "abc123xyz"
Control whether anonymous users (not logged in) can take the assessment through the examination settings.
settings: {
  examination: {
    allowAnonymous: true
  }
}

​
Best Practices

​
Organizing Your Content

  1. Use Categories: Group related questions into categories to create logical sections
  2. Set Prerequisites: Use category prerequisites to ensure progressive learning
  3. Balance Difficulty: Mix question types and difficulties for comprehensive assessment
  4. Clear Descriptions: Write concise descriptions so users know what to expect

​
Configuring Access

  • Set realistic time frames for examinations (minimum 1 minute, maximum 5 hours)
  • Consider allowing practice mode for learning-focused assessments
  • Use attempt limits to prevent gaming the system
  • Enable free navigation for less formal assessments

​
Maintaining Quality

All questions in a knowledge check must reference existing categories. The system validates this to prevent orphaned questions.
  • Ensure questions have at least 3 words to be clear and understandable
  • Assign appropriate point values to reflect question difficulty
  • Use the accessibility field to control which modes display each question

​
Next Steps

Question Types

Learn about the four question types available

Practice Mode

Configure unlimited practice with instant feedback

Examination Mode

Set up timed assessments with attempt tracking

Categories

Organize questions with prerequisites

Build docs developers (and LLMs) love

Get started for freeTalk to us