Skip to main content

Student guide

This guide covers everything students need to know about using the QR Attendance System.

Getting started

Registration

1

Navigate to registration page

From the login page, click the Register link.
2

Fill in your information

The Student Registration tab should be active by default. Enter:
  • Student ID: Your unique student identifier
  • Name: Your full name
  • Email: Valid email address for password recovery
  • Password: At least 8 characters
  • Confirm Password: Must match your password
3

Save your QR code

After successful registration, your unique QR code will be displayed. You can:
  • Take a screenshot to save it
  • Access it anytime from your dashboard after login
Your QR code contains your student ID and is unique to you. Keep it accessible for quick attendance marking.

Student dashboard

After logging in, you’ll see your personalized dashboard with three main tabs:

Dashboard tab

The main dashboard displays: Attendance Statistics
  • Total Check-ins: Total number of times you’ve marked attendance
  • Days Attended: Number of unique days you’ve attended
  • Last Attendance: Date of your most recent attendance
Your QR Code
  • Displayed prominently for easy access
  • Generated using QRCode.js (128x128 pixels)
  • Encodes your student ID
  • Show this to your teacher during class
Recent Attendance History
  • Shows your 10 most recent attendance records
  • Displays date, time, teacher name, and status for each entry
  • Status indicators:
    • On Time: Marked within the grace period
    • Late: Marked after the grace period
    • Absent: No attendance recorded

Profile tab

View and update your personal information: Profile Information
  • Name (read-only)
  • Student ID (read-only)
  • Email address
  • Class enrollment (if enrolled)
  • Teacher name (if enrolled)
Available Actions
  • Change Password: Update your account password
  • Update Email: Change your email address

Schedule tab

View your class schedule including:
  • Class name
  • Teacher name
  • Days of the week
  • Start times
  • Grace periods (how long after start time you can still be marked on-time)
If you’re not enrolled in any class yet, you’ll see a message indicating this. Contact your teacher to be added to their class roster.

Marking attendance

1

Display your QR code

Login to your dashboard and ensure the Dashboard tab is active. Your QR code is displayed in the center of the page.
2

Show QR code to teacher

When your teacher opens their QR scanner during class, hold up your device or show your saved QR code screenshot.
3

Wait for confirmation

The teacher’s screen will show a confirmation message:
  • ✅ On-time attendance marked
  • ⚠️ Late attendance marked
  • ❌ Error messages if there’s an issue
4

Check your dashboard

Your attendance history updates automatically. You can verify the record was created in the “Recent Attendance History” section.

Attendance status explained

Your attendance status is automatically calculated based on:
  • On-time: Scanned at or before start_time + grace_period
  • Late: Scanned after the grace period has expired
  • Absent: No QR code scan recorded for that class session
Check your class schedule to know the exact grace period for each class. Most classes have a 15-minute grace period by default.

Managing your profile

Changing your password

1

Open password modal

Click the Profile tab, then click Change Password.
2

Enter password details

  • Current Password: Your existing password
  • New Password: Your new password (minimum 8 characters)
  • Confirm New Password: Must match new password
3

Submit

Click Change Password. You’ll see a success message if the password was updated.
If you enter an incorrect current password, you’ll see an error: “Current password is incorrect”. Make sure you’re entering your current password correctly.

Updating your email

1

Open email modal

Click the Profile tab, then click Update Email.
2

Enter new email

Type your new email address in the form.
3

Submit

Click Update Email. You’ll see a success message if the email was updated.
Email addresses must be unique. If another student is using that email, you’ll see an error: “Email already in use by another account”.

Password recovery

If you forget your password:
1

Click Forgot Password

From the login page, click Forgot Password?
2

Enter your email

Provide the email address associated with your student account.
3

Check your email

You’ll receive a password reset link (requires email configuration by administrator).
4

Reset password

Click the link in the email and enter your new password.
Password reset tokens expire after 1 hour for security. If your link has expired, request a new reset.

Viewing your class information

Once enrolled in a class, you can view:

Class details

  • Class Name: E.g., “Computer Science 101”
  • Teacher Name: Your instructor’s name
  • Enrollment Status: Displayed in your profile

Schedule information

Click the Schedule tab to see:
  • Days the class meets
  • Start time for each day
  • Grace period (late arrival tolerance)
  • Calculated “late after” time

Attendance statistics

  • Total check-ins across all dates
  • Number of unique days attended
  • Most recent attendance date
  • Full attendance history with status for each session

Tips for students

Take a screenshot of your QR code immediately after registration. Save it to your device for quick access even if you can’t log in.
Check your schedule tab to know the exact grace period. Arriving within this window ensures you’re marked on-time.
Always check your “Recent Attendance History” after being scanned to ensure your attendance was recorded correctly.
Don’t share your password. Use the password reset feature if you forget it rather than sharing credentials.
Keep your email address current for password recovery and potential notifications from your institution.

Troubleshooting

My QR code won’t display

  • Clear your browser cache and reload
  • Ensure JavaScript is enabled
  • Try a different browser (Chrome or Firefox recommended)
  • Check browser console for errors

Attendance wasn’t recorded

  • Verify you’re enrolled in the teacher’s class
  • Check that today matches a scheduled class day
  • Ask your teacher to manually mark you present
  • Teachers can manually update attendance status from their dashboard

Can’t login

  • Verify you’re using your student ID, not email
  • Use the Forgot Password link if needed
  • Ensure Caps Lock is off
  • Contact your administrator if issues persist

Not enrolled in any class

  • Contact your teacher to be added to their class roster
  • Teachers manage enrollments through Manage Classes
  • You can be in multiple classes from different teachers

Next steps

View Your Schedule

Check your class schedule and grace periods

QR Attendance Feature

Learn more about how QR attendance works

Attendance Tracking

Understand attendance status and history

Teacher Guide

See what teachers can do in the system

Build docs developers (and LLMs) love