To keep your data secure, you have two ways to log in on a computer:
1. Direct Login (Official Email): If your institution has verified your domain, you can securely sign in directly using the "Continue with Google" button on the desktop site.

2. QR Code Login (Any Account):

1. Go to the aiClassrooms website on your computer. You will see a QR Code on the login screen.
2. Open the aiClassrooms Mobile App on your phone.
3. Tap the Menu (☰) in the top right corner and select "📷 Scan Web Login".
4. Point your phone camera at your computer screen. Your computer will instantly log in!

Note: For your security, if your computer is inactive for 15 minutes, the screen will lock and blur out. Simply scan the on-screen QR code with your phone to instantly unlock and resume your work.

To guarantee absolute privacy and security on shared classroom podiums or lab computers, logging out of the web browser immediately erases all temporary files, local class records, and login sessions from that computer. This leaves zero trace behind. Your mobile app and personal phone session remain fully intact and unaffected.

If your mobile app's QR scanner shows that you are not logged in or cannot log you into the desktop site:

1. Export All Subject Excels: Open each subject in your mobile app, tap the 📥 Download Excel button at the top of the screen, and download the Excel file 1 by 1 so all your latest attendance and marks are safely preserved on your phone.
2. Delete the App: Delete / uninstall the aiClassrooms app from your phone.
3. Install Again: Install the app fresh from the Google Play Store or Apple App Store.
4. Log In Cleanly: Sign in with your Google account.
5. Upload Attendance: If any subject attendance is not synced, upload the attendance spreadsheet for that subject 1 by 1 from your saved Excels.
6. Scan Again: Tap Menu (☰) > 📷 Scan Web Login and scan your computer screen. You will log in immediately!

In Educator Mode, click the + New Class button. Fill out the subject name. The app will generate an 8-character Enrollment Code that you share with your students.

In Student Mode, click + Enroll Class and enter the 8-character Enrollment Code provided by your educator. Depending on the class enrollment state set by the educator, access is granted as follows:

• 🔓 Open (7-Day Free Window): Any student with the code can enroll and set/correct their Roll Number and Name immediately. Classes remain open for 7 days before automatically switching to List Only mode.
• 📋 List Only (Restricted / Auto-Closed): Only students whose Roll Number or Name were pre-uploaded in the class roster by the educator can enroll and claim their spot. Unlisted students are blocked with a registration prompt.
• 🔒 Closed (Locked): Enrollment is completely closed. No new students can join.

Educators have complete control over who joins their class by toggling the Enrollment Badge in class details:

• 🔓 Open (Green - 7-Day Window): Open enrollment with student self-registration. When a class is created or set to Open, a 7-day timer begins. During this window, students can freely join and edit their Roll Number or Name.
• 📋 List Only / ℹ️ Auto-closed (Orange): Restricted enrollment. After 7 days, open classes automatically switch to List Only mode to permanently freeze the roster against unauthorized edits and identity spoofing. Only students on the educator's roster can claim their profile. Unlisted students cannot enroll. (Tip: Educators can reset the 7-day timer anytime by clicking the badge through Closed -> Open).
• 🔒 Closed / Locked (Red): Complete lockdown. No one can enroll, even if they know the code or are on the roster.

Inside any enrolled class, students can tap the 📋 My Enrolled Data button:

• View Identity: View the exact Name, Roll Number, Email, and Official Email linked to the educator's class roster.
• Update Roll Number: If the class is within its 7-Day Open Window, students can tap Update Roll No to correct typos. Rate limits apply (up to 3 edits before a 30-day security lock).
• Editing Window Closed: Once the 7-day window expires or the class is in List Only/Closed mode, the roll number field is locked to prevent tampering. Students must ask their educator to unlock enrollment or adjust their record manually.
• Name Updates: Editing your Name in the 👤 Profile tab automatically updates your name in all your active, open classes!

If you import an Excel spreadsheet that includes student email addresses, the app provides Zero-Friction Auto-Enrollment!

• Students do not need to enter the class code or claim their profile. As soon as they sign in with their email, the class will automatically appear on their student dashboard.
• Anti-Hijacking Protection: Because the student's email is already registered to that class record, other users are completely prevented from claiming that roll number or profile.

When joining a class, enrollment and roster mapping depend on whether the educator has pre-uploaded an Excel student list:

• Roster Pre-Uploaded (Profile Claiming): If the educator uploaded an Excel list first, students can "claim" their profile by entering the Class Code and their Roll Number/Name. This works offline too! The claim will securely sync to the cloud once the student has an internet connection.
• Automatic Email Match: If emails were in the Excel file, the student is instantly enrolled without needing to claim.
• No Roster Uploaded: If the educator has not uploaded an Excel sheet (and the class is Open), students can enter the Class Code and type their Name/Roll Number to enroll normally.
• What if a student enters the wrong Roll Number? If a student makes a typo and links their account incorrectly, the educator can easily open 📋 Enrollment Data, click the edit (pencil) icon next to the student's name, and update the Roll Number. The correction will automatically sync back to the student's app, linking their profile correctly.

Every student's original joining timestamp is automatically recorded as their official Enrollment Date:

• Permanent Preservation: If a student temporarily leaves/archives a class and rejoins later, the system automatically detects their existing record and preserves their original join timestamp without overwriting it.
• Excel & Google Drive Priority: When an educator exports records or syncs with Google Drive, the Enrollment Date is cleanly formatted (e.g. 27 Aug 2026, 04:30 PM) and placed in a dedicated column directly on the class enrollment sheet.
• Student Visibility: Students can view their exact recorded enrollment timestamp anytime inside 📋 My Enrolled Data.

Students can safely transfer their enrolled profile to a new Google account:

• Start on your Phone: Sign in with your new Google account on your registered device, enter the class code, and submit your enrollment details.
• Receive an Unlock Code: The app will generate a secure 4-digit Unlock Code on your screen.
• Teacher Approval: Share this 4-digit code with your educator. Your teacher will verify and approve the transfer directly from their class roster.
• Seamless Migration: Once approved, all your past attendance records, enrolled subjects, and quiz marks are automatically transferred to your new account.

To maintain fairness and prevent proxy attendance, each device can only be registered to one student in a class:

• If a phone is already linked to an enrolled student, another student cannot use the same phone to join that class.
• Swapped phones or shared in an emergency? If you legitimately changed phones or had to share a device, simply ask your educator to unlock or update your device access in their class roster.

In Educator Mode, open your class and tap 📥 Upload Student List / Attendance on the class menu. You have three powerful AI options:

• Upload Excel/CSV: Automatically maps headers (Roll, Name, Phone, Email, Official Email) and past attendance dates (P/A).
• Paste Raw Text: Paste text lists from WhatsApp or Notes. The AI auto-detects roll numbers, names, and dates.
• Photo/PDF AI (Vision): Take a photo of a printed or handwritten attendance sheet. The AI scans and maps it directly to your class roster.

Go to 📋 Enrollment Data inside your class and click the 👤 Add Students Manually button to enter individual roll numbers and names.

Educators can choose between three secure methods for students to check in:

• QR Code: The educator's screen displays a QR Code that students scan using their app.
• 4-Digit Code: The educator's screen displays a 4-digit code that students manually type in.
• Bluetooth (Mobile App Only): The educator's device broadcasts a secure signal, and students simply tap to check in automatically. Note: Browsers cannot start a Bluetooth broadcast, so this option is only available when starting a session from the mobile app.

This is a frictionless way to mark attendance. When an educator starts a session, their device broadcasts a secure, invisible signal via Bluetooth. Students simply tap Mark using Bluetooth; their phone scans for the signal and marks them present automatically—no typing required!

Once a student successfully marks their attendance, their screen displays a green QR code. Classmates sitting behind them can tap the Scan Peer Code camera button to scan this QR. This creates a fast chain-reaction of attendance across the room without everyone needing to scan the teacher's board.

Note: Educators can disable this feature by selecting "Host Only" QR Mode before starting a live session, which prevents students from generating their own peer-to-peer QRs.

To prevent proxy attendance (e.g., students sharing codes in WhatsApp), the educator enters a visual "Headcount" of how many students are physically in the room. Once that exact number of students successfully check in, the system locks down and blocks any further attempts, displaying a "Headcount Limit Reached" error.

Educators can enforce a geofence by requiring location. They can select 📍 Current Location (their immediate GPS coordinates) or 🗺️ Custom Location (dropping a pin on a map for a remote guest lecture). Students must grant location permissions and be physically within that exact radius to mark attendance.

Educators have two convenient ways to publish attendance:

• ⚡ Save & Publish (Daily Attendance): Located directly on the Take Attendance screen. Clicking this button immediately saves your changes locally and smartly notifies only the specific students whose attendance was modified (e.g. marked absent or present).
• 📢 Publish Attendance Summary (Dashboard): Located on the class dashboard and Assessment Hub. This updates the overall attendance records on the cloud and notifies students of any changes in their total percentage. To protect students from notification spam, it includes a 15-minute anti-spam guard.

The Take Attendance screen provides a streamlined 2x2 action grid:

• ❌ Don't Save (Red): Instantly discards any unsaved modifications and exits.
• ✅ Publish & Sync (Green): Saves attendance locally, publishes to student portal, and backs up data to Google Drive.
• 💾 Local Save (Blue): Saves attendance locally on this device without publishing or cloud backup.
• 🗑️ Delete (Dark Red): Permanently deletes the attendance session for this date (requires typing "delete" to confirm).

The app features a strict Roll Number Conflict Guard. Before any student can join a class with a Roll Number, the system verifies whether that specific ID is already claimed. If another account already registered that Roll Number, the second student is immediately blocked with an alert asking them to contact their educator. Duplicate prevention relies entirely on the Roll Number to ensure each student represents a unique individual.

Go to 📋 Enrollment Data. In the 2x2 action grid and student list:

• Edit Roll Number / Details: Tap the pencil icon next to a student to modify their Roll Number, Name, or Custom Fields. Any corrections automatically sync to the student's app!
• Official Email: Verified official email addresses are displayed directly in the enrollment table.
• Delete Student: Use the trash can icon (or swipe left) to delete a student from the roster.

To prevent cheating, student accounts are hardware-locked to their specific phone. If they get a new phone or need to switch, the educator must go to 📋 Enrollment Data, tap the student, and click Unlock Device to reset their device lock.

Go to 📋 Manage Attendance. In the attendance table, locate the specific date column and student row, and click the P/A button to flip their status manually.

On the Take Attendance screen, look for the Class Status setting. Switching from a "Working Day" to a "Holiday" or "Leave" will instantly update the table. Holidays are colored Blue, Leaves are Purple, and neither will penalize your students' attendance percentages!

The app features a Weighted Attendance engine. If you configured different durations in your Specific Timings, the app automatically gives more weight to longer classes when calculating percentages. If the app detects varying class lengths without a schedule, it will smartly prompt you to pick the duration before saving!

Yes! You can click on the column headers (Roll No, Full Name, or Summary) to instantly sort the table ascending or descending.

If you made a mistake on a past date, open that date in the Take Attendance screen, scroll to the bottom, and click the red 🗑️ Delete button. For security, you will be required to type "delete" to confirm before the record is erased.

Educators can build dynamic enrollment forms for their students. Inside your class, tap 📋 Manage Enrollment and click 📝 Edit Form (or configure it directly during initial class setup) to access the Form Builder:

• Change the primary ID header (e.g., from "Roll No." to "University ID" or any Custom Name during initial setup).
• Set the Phone Number requirement (Mandatory vs Optional).
• Add unlimited custom fields (like "Department" or "Year") that students must fill out when joining your class.

When creating or editing a class, you can add Specific Timings. You can set the Day (Mon-Sun), Start Time, End Time, and assign a specific Room Number for each lecture. The app uses these timings to intelligently sort your classes and trigger smart notifications.

Smart Schedule UI: The app also uses this data to smartly highlight your dashboard. Active classes happening today are fully highlighted with a bold background, while the very next upcoming class (even if it's next week) is automatically bolded so you always know what's next!

On your main dashboard, tap the three dots (⋮) on any class card and select ✏️ Edit Class. You can modify the name, section, timings, and rooms. Note: The app safely handles renaming and will instantly migrate your local database without losing any data. Furthermore, any edits you make are dynamically synced in real-time to all your enrolled students!

Tapping 📦 Archive Class removes it from your active dashboard and moves it to the "Educator Archives" tab. To keep your daily workspace clean and clutter-free, archiving stores completed classes in an organized archive while perfectly preserving your full attendance and marks records offline.

Automatic Student Sync: When an educator archives a class, it automatically archives the class on all enrolled students' devices as well. This keeps students' active class lists uncluttered and ensures everyone stays in sync (which is why students don't need a manual archive button).

Yes! Navigate to the 📦 Educator Archives tab on the bottom menu. Your archives are neatly organized by Year and Month. Simply find the class and click Restore to bring it back to your active dashboard with all data intact.

When you open a specific class, your bottom navigation bar transforms! The tabs change to give you direct access to Class Messages (for broadcasting announcements) and Quiz & Marks (the Assessment Hub), provided the class has been synced to the cloud.

Navigate to the Quiz & Marks tab and select an exam. You can quickly enter numerical marks with up to 2 decimal places of precision (e.g. 17.50, 8.25) for each student. The app also supports special status codes: typing ABS (Absent), DET (Detained), UFM (Unfair Means), or OTH (Other) will automatically format the text in bold purple.

Yes! If you accidentally enter a mark that is higher than the maximum allowed total, the app will highlight the input in bold red to instantly alert you.

In the Assessment Hub, tap Upload Marks and select your file. The app will automatically scan your sheet and suggest column mappings for Roll/Name and your Exam columns. You can manually tweak them before hitting "Import" to seamlessly merge the data.

Yes! Tap Photo/PDF Using AI in the Upload Menu. You can upload an image or a PDF. The app's built-in cropper will let you draw a box around the exact table you want to scan, and the AI will extract the names and scores instantly.

No problem! You can crop student names from one photo, and then click Add Another Part to crop the marks from another photo. The AI will merge them together for you side-by-side!

The Online AI uses the cloud to read messy handwriting and multi-page tables. The Offline AI is faster and works without internet, but requires clean, printed text tables and cannot combine multiple photos together.

The app allows you to add text remarks or notes for students. Click the column toggles to show the Remarks column, or use the dedicated Manage Remarks screen. These notes are saved securely and are perfect for documenting behavioral observations or assignment notes.

When an educator publishes solutions or finalizes a quiz, any enrolled student who did not attempt or submit the test is recorded with 0 marks. This ensures that final percentage calculations, grade distributions, and class performance averages remain mathematically accurate without null gaps.

Yes! All submitted quiz scores, teacher remarks, and published assessment summaries are securely linked to your authenticated student account in the cloud database. If you reinstall the app or log in on a new device, your complete academic records and past quiz marks are automatically restored.

Open a class that has been synced to the cloud, and tap the Class Messages tab at the bottom. Type your message and hit send! The app will instantly send a Push Notification to all your enrolled students.

By default, class messaging is a one-way announcement board. Students cannot reply. However, educators can click the ⚙️ Chat Permissions icon in the top right to selectively allow specific students to reply (e.g., Class Representatives).

To maintain a streamlined and distraction-free environment for official announcements, the class messaging system is designed as a one-way broadcast by default. Only educators and designated representatives possess reply privileges.

It's perfect for declaring surprise tests, communicating unexpected leaves, or sharing important study materials. You can attach multiple files (such as PDFs, PPTs, or images) directly to your messages, which are securely synced to your cloud storage. You can also paste links to external resources, and they will be directly clickable for students.

Class messages are intended for group-wide announcements and do not support private direct messaging. If you need to discuss a personal matter, please utilize the educator's official email address provided in their profile to ensure a professional and secure correspondence.

The app features an intelligent Read Receipt system! In the chat, you will see a small "Read by X" indicator at the bottom of your messages showing exactly how many students have seen it.

No, to maintain a clean database and protect privacy, all class messages are automatically and permanently deleted after 7 days.

Simply Long-Press any message bubble in the chat! Your phone will vibrate slightly, and the text will be instantly copied to your clipboard. Long URLs are beautifully shortened for readability but will copy fully.

The app creates a folder in your Google Drive called "aiClassrooms Backups". Inside, it saves a compressed master backup file (aiClass_yourname_dd-MM-yy-hhmm.json.gz) containing your complete classes, settings, and enrollment codes, as well as beautifully formatted Excel files (.xlsx) for every active and archived class, complete with Summary Dashboards, Enrollment, Attendance, and Marks sheets.

Whenever you tap Cloud Sync on the mobile app (Android or iOS), aiClassrooms automatically saves a dual backup:

• 1. Encrypted Cloud Backup: Saves directly to your Google Drive (aiClassrooms Backups/aiClass_yourname_dd-MM-yy-hhmm.json.gz) using high-speed native compression. This is the primary and most seamless restore method across all platforms.
• 2. Local Device Backup: Saves an exact offline copy to your phone's Downloads storage (aiClass_yourname_dd-MM-yy-hhmm.json).
• Desktop Web Note: When syncing from a desktop web browser, the app syncs exclusively to your Google Drive cloud to keep your computer's Downloads folder clean and free of file spam.
• Smart Auto-Pruning: The app automatically replaces and prunes older backup files created for your account, preventing device storage or Google Drive from becoming cluttered over time.

Restoring Your Data After a Reinstall:
When you reinstall the app or open it on an empty device, the Restore Data prompt appears:

• Pull from Cloud (Recommended): Tap ☁️ Pull from Cloud to restore the latest backup from Google Drive seamlessly.
• Android Local Restore: On Android, your previous local backup files (aiClass_yourname_*.json) remain safely stored in your device's Downloads folder. Because Android security isolates reinstalled apps from automatically scanning Downloads, simply tap 📁 Choose Backup File from Device and select your file from Downloads to restore instantly offline.
• Apple iOS Note: On iOS, uninstalling an app permanently clears its sandboxed local storage. Restoring on iOS is done effortlessly via Google Drive cloud backup (or by selecting a backup file if you previously exported one to the Apple Files app).
• Choose Backup from Device: You can select any valid .json or .gz backup file directly from your storage anytime.

Before deleting or uninstalling the app from your device, take one of the following simple steps to ensure you never lose your data:

• 1. Sync to Google Drive (Recommended): If you have internet access, tap Cloud Sync in the top navigation. Your complete database is uploaded to your Google Drive (aiClassrooms Backups/aiClass_yourname_dd-MM-yy-hhmm.json.gz). When you reinstall the app, simply log in and tap ☁️ Pull from Cloud to restore everything instantly!
• 2. WhatsApp or Share your Local Backup File: Every sync on mobile automatically saves an offline backup file (aiClass_yourname_dd-MM-yy-hhmm.json) in your phone's Downloads folder. You can easily share this file via WhatsApp (e.g. to yourself), email it, or save it to an external drive. After reinstalling, tap 📁 Choose Backup File from Device to restore all records offline.
• 3. Apple iOS Warning: iOS permanently wipes all sandboxed app files upon app uninstallation. Apple users must always perform a Google Drive Sync or export their backup file to the Files app / iCloud Drive before uninstalling.

To prevent accidental data corruption or overwriting another educator's database, the restore engine enforces strict Account Isolation. If you attempt to restore a backup file that was generated under a different user email, the app will reject the file to protect your database integrity.

If you don't have internet access or prefer offline restoration:

• Ensure your backup file (aiClass_yourname_*.json or .gz) is on your device (in Downloads, WhatsApp received files, or local storage).
• When opening the app on an empty device, look below the cloud restore options for "If you have a backup file on this device, choose it to restore:" and tap 📁 Choose Backup File from Device.
• Select your file, and the app will instantly restore all your classes, students, attendance, and marks offline!

You can safely use aiClassrooms on multiple devices (like your phone and your tablet). If you mark attendance on your phone and sync, and then later sync on your tablet, the app will merge the data from both devices automatically without overwriting or losing any records.

To save your time and mobile data, the app only uploads files for classes that have actually changed since your last backup. If a class has no new attendance or marks, the app simply skips it.

If you delete a class on one device, the app remembers this. When you sync your other devices, they will automatically delete that class too, preventing deleted classes from popping back up.

Yes! On your new phone or fresh install, sign in with your Google account. The app features a Proactive Cloud Restore engine with smart deduplication:

• The app immediately checks if you have synced classes in the cloud and presents a 1-tap restore prompt.
• Deduplication Guard: Merges cloud and local records seamlessly so you never get duplicate class cards or lose offline modifications.
• You can also click Restore from Drive anytime to restore full historical Excel spreadsheets and archive backups.

Yes. Inside any class, tap the 📥 Download Excel button at the top of the screen. This will instantly generate and download the spreadsheet directly to your device without requiring a full Google Drive upload.

The first sheet of every exported Excel file contains a high-level summary including Total Students, Tracked Hours, Holidays, and an Attendance Bracket breakdown showing exactly how many students are in the Red (0-25%), Orange (26-50%), Yellow (51-75%), and Green (76-100%) zones.

If your sync button is Red 🔴 (meaning local attendance or changes are waiting to be uploaded to the cloud) or you encounter a sync error:

Method 1: Two-Way Desktop & Phone Sync

1. Open your computer / laptop browser and go to aiClassrooms.org.
2. Click the Sync button on your desktop screen.
3. Then immediately tap Sync on your mobile phone.
4. This establishes a two-way synchronization handshake that clears the pending state and turns the sync button Green 🟢.

Method 2: Safe Excel Backup & Fresh Reinstall

1. If sync still fails or remains red, do NOT delete the app right away.
2. Go into each subject one by one: open the subject and tap the 📥 Download Excel button at the top of the screen to save the attendance spreadsheet for all your subjects safely to your phone storage.
3. Once you have downloaded the Excels for all subjects, delete the app from your phone.
4. Install the app again from the Google Play Store or Apple App Store.
5. Log in with your Google account and upload the attendance for each subject 1 by 1 from your saved Excel sheets.

• 🟢 If Sync is Green (No attendance pending): It is 100% safe to delete the app and install it again. All your classes, attendance, and marks are safely stored in the cloud. They will restore automatically when you log back into your Google account.
• 🔴 If Sync is Red (Attendance pending): Do NOT delete the app yet! Either use the desktop sync method above, or download the Excel spreadsheets of all your subjects 1 by 1 to your phone before deleting the app. Once saved, you can reinstall safely and re-upload.

To sign out normally, go to ⚙️ Settings, scroll to the bottom, tap Sign Out, and type sign out to confirm.

If the app is frozen, unresponsive, or fails to sign out:

• Check the Sync icon: If the sync icon is Green 🟢, your data is already safely stored in the cloud. You can safely delete the app and install it again.
• If the sync icon is Red 🔴: Export the Excel spreadsheets for all your subjects 1 by 1 first (via the 📥 Download Excel button at the top of each subject) so your records are safe. Then delete the app and install it again.
• When you launch the reinstalled app, you will be on a fresh login screen ready to sign in.

Yes! The app is designed to work offline. If you open the app without internet, it will load instantly using the files stored on your device. You can safely take attendance or practice quizzes completely offline. Once you reconnect to the internet, the app automatically syncs your data and updates itself in the background!

The app securely links your student account to your specific phone. This ensures that only you can mark your attendance from your own device, preventing anyone else from doing it for you.

For strict security and anti-cheat integrity, the web platform enforces an approved browser whitelist:

• Supported Browsers: Google Chrome, Microsoft Edge, Safari, or the Official Mobile Apps (Android & iOS).
• Why other browsers are blocked: Browsers like Firefox, Opera, and Brave modify or randomize device hardware identifiers and lack standardized Web Bluetooth and secure storage APIs needed to prevent proxy attendance and exam cheating.

You will see red notification badges on your class cards and tabs whenever a new Quiz, Mark, or Class Message is posted. You will also receive push notifications directly to your phone.

Yes! The app uses your phone's native face or fingerprint lock. Don't worry if your device has older or weaker hardware; the app includes safe fallbacks to ensure you never get locked out of your account.

The app has a built-in Safety Lock. If you have an active attendance session or quiz running and accidentally tap to leave or close the screen, the app will instantly pause and ask for confirmation before ending the session, ensuring you never lose data by mistake!

For educators using public classroom computers (like a podium), aiClassrooms features strict security. If the computer is left idle for 15 minutes, the app automatically drops a blurred lock screen to protect your data from students. To unlock the screen, simply open your mobile app and scan the QR code to instantly resume exactly where you left off.

To prevent spam and save data, the QR login code automatically expires and blurs out if nobody scans it within 1 minute. If this happens, simply click the Refresh QR button to generate a new secure code!

No! Since you log in using a secure QR scan rather than a traditional password, clicking Logout on the desktop podium will only destroy the session on that specific computer. Your personal phone will remain securely logged in.

No! When you sign out of your account, notification services are immediately disconnected from your device. You will not receive any class alerts, messages, or exam announcements on that phone or computer after logging out.

In Educator Mode, you can attach a syllabus (PDF, Excel, or Text). The AI will instantly read your document and craft a balanced, multiple-choice quiz (including Easy, Moderate, and Difficult questions) complete with smart distractors.

If a student misses an exam or gets permanently locked out, you can generate a Make-Up Quiz. The AI will instantly write a completely new exam testing the exact same concepts but using different scenarios and numbers to prevent cheating!

Yes. Educators can manually toggle the Submissions: ON/OFF button for any quiz. If set to OFF, students will be blocked from submitting until you set it back to ON.

If the timer for a specific question runs out, don't worry! The app intelligently saves whichever option you currently had selected at that exact moment. You won't lose credit just because you couldn't hit the Next button in time.

• Strict Anti-Cheating: Instantly locks a student's exam if they switch apps or use split-screen.
• Server-Authoritative Grading: Answer keys are stored securely on the server and are never downloaded to student phones before submission. Tests are evaluated directly on secure cloud servers, preventing client-side inspection.
• Auto-Mark Attendance: Automatically marks a student "Present" for the day the moment they submit the test.
• Zero Microphone Overhead: Quiz security operates completely through window and lifecycle monitoring, without requiring intrusive microphone permissions.
• Delay Solution Release: Hides the answer key until 15 minutes after the exam time has fully expired for everyone.

Yes! Before publishing, a "Target Audience" screen allows you to select exactly which students will receive the quiz on their devices.

You can easily generate a Make-Up Quiz specifically for the absentees on the fly. The original quiz will be invisible to them, and other students won't receive notifications for the new quiz.

Students open the Quiz & Marks section in their student app and tap the active quiz. When the educator starts the broadcast, students can begin using any of three fast methods:

• 📷 Scan QR Code: Scan the Start QR Code displayed on the educator's screen.
• Bluetooth Start: Tap Mark / Start using Bluetooth to automatically detect the teacher's broadcast signal.
• ⌨️ 8-Character Access Code: Enter the uppercase 8-character Start Code shown on the educator's screen.

To ensure an anti-cheating, contained exam session on iPhone and iPad, Apple requires Guided Access to lock the device into the app so notifications, calls, and split-screen apps cannot disrupt the quiz:

1. Open iPhone Settings > Accessibility > Guided Access.
2. Turn Guided Access ON.
3. Essential: Turn Accessibility Shortcut ON. (Turning this on enables the triple-click side button shortcut to activate Guided Access immediately without confusion or secondary menus).
4. (Proctor recommendation): Tap Passcode Settings and set a Guided Access passcode so students cannot exit the quiz prematurely without educator authorization.
5. Return to the aiClassrooms app and tap on your active quiz.
6. Triple-click the side power button (or Home button on older iPhones) to lock into Guided Access and start your exam!

Note for Android Users: On Android devices, the app uses native Screen Pinning. Simply accept the on-screen Screen Pinning prompt when starting the quiz.

If a student's exam locks due to app switching or strict anti-cheating, the educator can tap 🔓 Unlock Students in the Quiz Control Room to start a live unlock session:

• Bluetooth Unlock: The educator's device broadcasts an unlock signal; students simply tap Bluetooth Unlock on their lock screen to resume immediately.
• 📷 Scan Unlock QR: Students scan the rotating QR code displayed on the educator's screen.
• 🔢 4-Digit Rolling Code: Students can type the temporary 4-digit code shown on the educator's live unlock banner.
• Individual Reset: Educators can also tap Reset Session directly next to any student's name in the live submissions list.

The educator's Quiz Control Room features a real-time Submissions dashboard showing each student's score, time elapsed, and Fairness Index. An abnormal drop in the Fairness Index (highlighted in red) alerts you if a student attempted to minimize the app, switch tabs, or trigger split-screen.

To prevent cheating, questions and options are scrambled for every student. Additionally, you will only see one question at a time.

No. You only need the internet to start the quiz and to submit it at the end. While you are actively answering questions, the timer and exam engine run completely offline!

Don't panic! The app will safely save your completed test to your device. You can safely exit the screen. Once you have internet again, just open the app and tap Retry Submission.

This is a security feature that blocks notifications and prevents you from accidentally exiting the exam.

How to set it up:

• Apple (iOS): Go to your phone's Settings > Accessibility > Guided Access and turn it on. Once inside the aiClassrooms app, triple-press the Power button (or Home button) to start Guided Access before starting the quiz.
• Android: Go to your phone's Settings > Security > Advanced > App Pinning (or Screen Pinning) and turn it on. To activate it, open your recent apps screen, tap the aiClassrooms app icon, and select Pin.

The app monitors your exam session. If you try to open split-screen, switch apps, or exit the exam, your Fairness Index drops and your educator will see it.

If your educator enabled Strict Anti-Cheating, your exam will instantly lock if you try to switch apps, open a split-screen, or use a floating window. You must walk up to the educator to get it unlocked.

The app securely binds the quiz to the physical hardware of the phone you started it on. If your phone dies and you must swap devices, the new device will show a massive red Unlock Code that you must show to your educator to authorize the swap.

If you manage to start the test on one device but somehow try to submit it on another, the app's hardware security will reject it. You will need to ask the educator for a Make-Up quiz.

If your educator enabled "Delay Solution Release", you must wait until the maximum exam time has expired for the entire class (plus 15 minutes) or until your educator taps Publish Solutions.

In the Quiz Control Room, clicking 📢 Publish Solutions immediately and permanently closes the exam, allowing all students who submitted to view the full answer key and explanations from the server.

Safety Protection: Because publishing solutions is irreversible (students who haven't submitted yet will be locked out and must take a Make-Up Quiz), the app requires the educator to type "publish" into a confirmation prompt before executing.

Yes! You can use the Practice Mock Quiz feature. Just upload a syllabus document (PDF, Spreadsheet, or Text) or type a topic, and the AI will instantly generate a custom practice test for you. This is an unlimited resource, highly useful for placement preparation or improving knowledge on weak subjects.

No, practice quizzes are purely for self-assessment. Your marks are only visible to you and are not sent to your educator.

Unlike real exams which pause or save your progress, practice quizzes are meant to be completed in one sitting. If you minimize or close the app, your practice progress will be immediately discarded.

Both official exams and practice quizzes launch in an isolated, distraction-free Fullscreen Interactive Overlay:

• Exam Mode Overlay: Isolates the student from background distractions and dashboard navigation. It continuously monitors window focus and app switching, preventing multitasking while displaying clear countdown timers and intuitive question navigation.
• Practice Quiz Overlay: Allows students to practice unlimited AI mock tests with instantaneous feedback, question explanations, and score breakdowns without navigating away from their dashboard.
• Quiz Short Names & Descriptions: Educators can configure concise quiz titles and descriptive summaries, which display cleanly across student cards and exported Excel reports.

To bring you the most advanced capabilities, the app securely communicates with powerful AI cloud servers to process complex tasks (like generating quizzes or reading handwritten marks). During periods of very high global traffic or brief network interruptions, the server might be too busy to respond instantly. If you see an error, simply wait a few seconds and try again!

Features labeled as Online AI (such as AI Quiz Generation or multi-page table scanning) require an active internet connection to contact our cloud servers. However, you can always fall back to the Offline AI for scanning perfectly printed tables without any internet access!

To use online AI features (like scanning attendance sheet photos or generating quizzes):

1. Go to Google AI Studio at https://aistudio.google.com/app/apikey.
2. Sign in with your Google account.
3. Click Create API key and copy the generated key.
4. Come back to the app and paste the key into the prompt dialog when you attempt to use any AI feature.

Your key is securely encrypted and saved directly to your account. You only need to do this once!

If your API key is invalid or expires, the app will automatically clear it and prompt you to enter a new one the next time you use an AI feature. You can get a new key for free anytime from Google AI Studio.

In Student Mode, click the Attendance Certificate button on any class card, or the Marks Certificate button on a submitted quiz. You can download these as images and share them directly to LinkedIn!

If your educator has verified their Official Email address, your certificate is automatically upgraded to the "Verified Tier," displaying a green checkmark to prove authenticity.

Anyone can open the aiClassrooms app, click the sidebar menu, select Verify Certificate, and scan the QR code printed on your certificate to instantly verify its authenticity against our cloud database.

Both educators and students can navigate to the 👤 Profile / Settings tab on the bottom menu to set their Display Name, Title, Institution, and personal preferences.

In your Profile page, enter your academic or official email address in the "Official Email" box and click Verify. You will receive a secure verification code via email to confirm your identity. Verifying your official email adds a checkmark to your profile and enables premium trust features (like issuing Verified Tier certificates for educators).

To maintain academic integrity and prevent identity fraud during exams and attendance, identity changes are strictly regulated:

• 3-Edit Limit & 30-Day Freeze: You can edit your Name or Roll Number up to 3 times to correct typos. After the 3rd edit, your identity is locked for 30 days.
• 7-Day Open Window Enforcement: Identity updates only cascade to enrolled classes if the class is within its 7-Day Open Window. Once a class switches to List Only or Closed, roster names are permanently locked to preserve official records.
• Need an emergency fix? If your details are frozen or the window has closed, ask your educator to update your roll number or name directly in their class roster.

To sign out on mobile:

1. Go to the ⚙️ Settings tab.
2. Scroll down to the bottom and tap Sign Out.
3. Type sign out in the prompt to confirm.

This logs you out and securely clears your session from the device, returning you to the login screen for easy account switching.

What if the app gets stuck or won't let you sign out?

• If your Sync is Green 🟢: All your classes and attendance are already safely synced in the cloud. You can safely delete the app and reinstall it from the app store.
• If your Sync is Red 🔴: Before deleting the app, download the Excel spreadsheets for all your subjects 1 by 1 (via the 📥 Download Excel button at the top of each subject) to preserve your attendance. Then delete the app, reinstall it, and log in cleanly.

Inside ⚙️ Settings, the collapsible ⚠️ Danger Zone allows you to permanently delete your account:

• Secure Cloud Recovery Vault: To protect against accidental loss or unauthorized deletion, your profile and class relationships are safely archived in a secure recovery vault before local data is erased.
• 1-Tap Instant Restoration: If you ever log back in using your original verified Google email, the system automatically detects your vaulted account and offers a 1-tap restore prompt to recover all your classes and profile settings seamlessly!

Both educators and students can bring their own free Google Gemini API key (BYOK - Bring Your Own Key) to power OCR vision scanning, PDF parsing, and unlimited quiz generation:

1. Profile Prerequisite: Ensure you have saved your Profile (Title & Full Name) in ⚙️ Settings first.
2. Enter API Key: In ⚙️ Settings > Gemini AI Configuration, paste your API key generated from Google AI Studio.
3. Tap Verify & Save Key: The app instantly verifies your key with Google's API to ensure validity before saving.

Encrypted Cloud Sync: Your verified key is encrypted and safely stored with your account. Whenever you sign in on a new device (such as your phone, tablet, or classroom computer), your key is automatically restored so you never have to re-enter it!