Skip to main content
Once you’ve created a knowledge check, you can share it with others and control who has access.

​
Share Tokens

Every knowledge check receives a unique share token upon creation. This token is used in URLs to access the check.

​
Share URL Format

https://your-domain.com/checks/[share_token]
https://your-domain.com/checks/[share_token]/practice
  • The first URL opens the check in examination mode
  • The second URL opens the check in practice mode
Share tokens are automatically generated and cannot be customized. They remain constant for the lifetime of the check.

​
Access Control Settings

Configure who can access your check through the Settings section during creation or editing.

​
Share Accessibility

The Share Accessibility setting determines if your check is publicly discoverable:
  • Enabled: The check appears in public listings and the discover page
  • Disabled (default): The check is only accessible via direct share token URL
For private assessments shared with specific groups, keep share accessibility disabled and only share the direct URL.

​
Anonymous Access

In the Examination Settings, the Allow Anonymous option controls whether users without accounts can take your check:
  • Enabled: Anyone with the link can take the check, even without logging in
  • Disabled: Users must authenticate before accessing the check
Enabling anonymous access makes your check more accessible but provides less control over who takes it. Use this carefully for sensitive assessments.

​
Authentication Requirements

KnowledgeCheckr requires authentication for taking checks, with these options:

​
Full Account

Users can create accounts using:
  • Email and password
  • GitHub OAuth
  • Google OAuth
  • Dex OpenID Connect (if configured)
Full accounts persist across sessions and devices.

​
Anonymous Account

If anonymous access is enabled for a check:
  • Users can sign in anonymously without credentials
  • Data is stored temporarily
  • Anonymous users can link their account to a full account to preserve data
  • Signing out deletes all anonymous user data (unless examination results exist)
Anonymous accounts are useful for quick assessments but should be linked to a permanent account to preserve progress.

​
Sharing Methods

​
Direct URL Sharing

The simplest method:
  1. Copy the share token from your check
  2. Construct the URL: /checks/[share_token]
  3. Share the URL via:
    • Email
    • Learning management systems
    • Messaging platforms
    • QR codes

​
Public Discovery

For open access:
  1. Enable “Share Accessibility” in check settings
  2. Users can find your check on the discover page
  3. Check appears in public listings

​
Restricted Distribution

For controlled access:
  1. Keep “Share Accessibility” disabled
  2. Optionally disable “Allow Anonymous”
  3. Share the direct URL only with intended users
  4. Users must authenticate to access

​
Availability Windows

Control when your check is accessible using date settings:

​
Check Open and Close Dates

Set in the Basic Information section:
  • Open Date: When the check becomes available
  • Close Date: When the check expires
Users cannot access the check outside this window.

​
Examination Start and End Dates

Set in Examination Settings:
  • Start Date: When examination mode becomes available
  • End Date: When examination mode closes (optional)
Practice mode is not affected by these dates.
Use different date ranges for check availability and examination periods. For example, keep the check open for practice after the examination period ends.

​
Collaboration

Share editing rights with other users:

​
Adding Collaborators

  1. During check creation or editing, find the Collaborators field in Basic Information
  2. Select users from your organization
  3. Collaborators can:
    • View the check details
    • Edit questions and settings
    • View results and analytics
    • Cannot delete the check (only the owner can)
Collaborators must be existing users in the system. You cannot add external users as collaborators.

​
Attempt Management

Control how many times users can attempt your check:

​
Practice Attempts

In Practice Settings:
  • Allowed Practice Count: Set a maximum number of practice sessions
  • Set to null for unlimited practice
  • Minimum: 1 attempt

​
Examination Attempts

In Examination Settings:
  • Examination Attempt Count: Maximum formal exam attempts
  • Minimum: 1 attempt
  • Each submission counts as one attempt
  • Users are blocked after reaching the limit
Be generous with attempt counts for learning-focused checks. Restrictive limits can frustrate users.

​
Monitoring Access

As a check owner, you can:
  • View all user attempts from your checks dashboard
  • See completion rates and scores
  • Track when users access the check
  • Review individual question performance

​
Best Practices

​
For Public Checks

  • Enable share accessibility for maximum reach
  • Allow anonymous access to reduce barriers
  • Set generous attempt limits
  • Use longer availability windows
  • Provide clear instructions in the description

​
For Private Assessments

  • Keep share accessibility disabled
  • Require authentication (disable anonymous)
  • Share URLs only with intended recipients
  • Use shorter availability windows aligned with course schedules
  • Set appropriate attempt limits for formal evaluation

​
For Educational Use

  • Enable practice mode for learning
  • Allow unlimited practice attempts
  • Use categories to organize topics
  • Set multiple exam attempts to reduce test anxiety
  • Provide clear open and close dates

​
For Certification

  • Disable anonymous access
  • Limit examination attempts (1-3 typical)
  • Set strict time limits
  • Disable free navigation to prevent answer review
  • Randomize questions and answers
  • Use exam-only questions for key assessment items

​
Security Considerations

  • Share tokens are unique but not secret - anyone with the token can access the check
  • Use authentication requirements for sensitive assessments
  • Monitor attempt patterns for unusual activity
  • Set appropriate availability windows to limit exposure
  • Consider disabling anonymous access for high-stakes assessments

​
Updating Share Settings

You can modify share settings at any time:
  1. Navigate to your checks dashboard at /checks
  2. Select the check to edit
  3. Update settings in the Settings section
  4. Save changes
Changes to share settings take effect immediately and apply to all future access attempts.

Build docs developers (and LLMs) love

Get started for freeTalk to us