How can we help?

The Kwagly workflow

Kwagly has two apps that work together: the web dashboard (for managing everything) and the mobile app (for scanning). Here's the full loop:

1. 1
   Create a class on the web dashboard — give it a name, subject, and grade level.
2. 2
   Add students to the class — manually, or import them from a CSV file.
3. 3
   Create a quiz — set the number of items, choices per item, and fill in the answer key.
4. 4
   Generate an answer sheet — export as PDF or DOCX, then print and distribute to students.
5. 5
   Scan with the mobile app — point your phone at a completed answer sheet; Kwagly grades it automatically in under 2 seconds.
6. 6
   Review results on the web dashboard — see scores, item analysis, and class analytics.

Creating your account

1. 1
   Go to kwagly.com and tap Sign up.
2. 2
   Enter your email address and choose a password (minimum 8 characters, with at least one uppercase letter and one number).
3. 3
   Check your inbox for a verification email and click the link inside. You must verify your email before you can use Kwagly.
4. 4
   Once verified, you're taken to the dashboard automatically.

Editing your profile

Go to Profile (bottom of the sidebar on web, or the Me tab on mobile). You can update your display name and change your password from the Account section.

Changing your password

1. 1
   Open Profile → tap Change password.
2. 2
   Enter your current password, then your new password twice.
3. 3
   Tap Save. You'll stay signed in.

Plan tiers

Signing out

Profile → Sign out. On web, you can check Remember me at login to stay signed in across browser sessions.

Creating a class

1. 1
   Go to Classes in the sidebar.
2. 2
   Tap New class (top right).
3. 3
   Enter the class name, subject, and grade level. Pick a colour.
4. 4
   Tap Save. Your class appears in the list immediately.

Class detail

Tap any class to open its detail view. You'll see the student roster, linked quizzes, and a summary of recent scan activity. From here you can edit the class name, add students, or link quizzes.

Deleting a class

Open the class → tap the ⋯ menu → Delete. You can only delete a class once all quizzes linked to it have been deleted first. Students are not deleted when a class is deleted — they remain in the Students list.

Adding students manually

1. 1
   Open a class and tap Add student, or go to Students → New student.
2. 2
   Enter the student's first name, middle name (optional), last name, and LRN (optional).
3. 3
   Tap Save.

Importing from CSV Web only

1. 1
   Go to Students → Import CSV.
2. 2
   Select the target class (or create one).
3. 3
   Upload your CSV file. Required columns: First Name, Last Name. Optional: Middle Name, LRN.
4. 4
   Review the preview — each row shows its status: New, Enroll, Registered, Skip, or Error.
5. 5
   Tap Import to commit.

Filtering and sorting students

The Students table on the web has sortable columns (First Name, Middle Name, Last Name, LRN, Classes) and per-column text filters. Use the Class filter dialog to filter by class membership using CONTAINS, EQUALS, or NOT EQUALS rules.

Deleting students

Students can always be deleted. Select one or more rows and tap Delete. Note: deleting a student does not delete their scanned papers — historical results are preserved.

Creating a quiz

1. 1
   Go to Quizzes → New quiz.
2. 2
   Enter a title, select the number of items (10, 20, 25, 50, or 100), and the number of choices per item (4 or 5).
3. 3
   Optionally link the quiz to one or more classes.
4. 4
   Tap Save, then tap Edit answer key to fill in the correct answers.

Editing the answer key

The answer key screen shows a grid of all items. Tap each item and select A, B, C, D (or E for 5-choice quizzes). You can navigate with the keyboard on desktop. The key is saved automatically.

Quiz detail

Tap a quiz to open its detail screen. You'll see a summary of all scanned papers for that quiz, the answer key, and links to the item analysis report. From here you can also generate an answer sheet.

Deleting a quiz

A quiz can only be deleted if it has zero scanned papers. Delete all papers for that quiz first, then delete the quiz.

Generating a sheet

1. 1
   Open a quiz and tap Generate answer sheet, or go to the Sheets screen.
2. 2
   Tap Export PDF or Export DOCX.
3. 3
   The file downloads to your computer. Open and print from any PDF or Word viewer.

Print layout

Both PDF and DOCX use legal landscape (13 × 8.5 inches) with two sheets per page separated by a dashed cut guide. Print double-sided if you want to save paper, or print single-sided and cut along the guide.

What's on the sheet?

Scanning a sheet

1. 1
   Open the mobile app and tap the Scan button (center of the bottom tab bar).
2. 2
   Select the quiz you're grading from the quiz picker.
3. 3
   Point the camera at the answer sheet. Four corner viewfinders appear on screen.
4. 4
   Align the sheet so all four corners are visible in the viewfinders. When all four turn green, the app auto-captures.
5. 5
   The grading result appears immediately — score, per-item answers, and any flagged items.
6. 6
   Review and tap Save (or override any flagged items first).

Lighting and positioning tips

• Use bright, even lighting. Avoid harsh shadows across the sheet.
• Keep the sheet flat — no curls or folds over the bubble area.
• Hold the phone parallel to the sheet, not at an angle.
• The sheet doesn't need to fill the entire screen — keep some margin around all four corners.
• Natural daylight or a well-lit desk lamp works better than overhead fluorescent light.

Flagged items

Items where the scanner isn't confident (e.g. lightly filled bubble, stray mark, double-mark) are highlighted with a flag badge. Tap any flagged item on the review screen to see the detected answer and override it manually.

Offline scanning

Scans are saved to your device immediately, even without an internet connection. As soon as connectivity is restored, the app silently uploads all pending scans in the background. You'll see a sync indicator if there are papers waiting to upload.

Viewing papers

Go to Papers in the sidebar to see all scanned papers across all quizzes. You can filter by quiz, class, or student. Tap any paper to see the full per-item breakdown, score, and flagged items.

Quiz summary & item analysis

Open a quiz and tap View summary to see the full analytics report. The report follows the DepEd/CHED psychometric standard and includes:

Score distribution

The summary screen shows a histogram of scores across 10 buckets, with a passing-line annotation at 75%. This gives you an at-a-glance view of how the class performed.

Student history

Go to Students → tap a student → View history to see all quizzes that student has taken, their scores, and a trend over time.

Analytics dashboard

The Analytics page shows class-wide statistics: total papers, average score, pass rate, and recent scan activity across all your quizzes.

CSV import format (students)

Your CSV file should have a header row. Accepted column names (case-insensitive):

Answer sheet export tips

• Use PDF for most printers — it preserves exact sizing.
• Use DOCX if you need to add a school letterhead or custom header above the sheet.
• Both formats use legal-landscape, 2-up layout. Print at 100% scale.

Settings are accessible from the bottom of the sidebar on the web dashboard. The mobile app's preferences live inside the Profile screen.

Danger zone

The recommended deletion order is: Papers → Quizzes → Classes → Students. Kwagly will block you if you try to delete in the wrong order (e.g., you can't delete a quiz that still has papers).

For answer sheets

• Always print at 100% scale with no page scaling.
• Use a laser printer for crisp fiducials and bubbles. Inkjet works but may bleed on humid days.
• Print on 80 gsm paper or heavier — thin paper can cause show-through from the other side.
• Cut along the dashed guide before distributing — one sheet per student.
• Tell students to use a dark ballpen or 2B pencil and fill bubbles completely.
• Remind students not to fold the sheet — creases over the bubble area confuse the scanner.

For scanning

• Scan at a desk or table, not hand-held in the air — flat surfaces give the most consistent results.
• Keep a dark background under the sheet (a dark desk or folder) so the white sheet stands out.
• Scan in natural daylight or under a bright desk lamp — avoid direct overhead fluorescent strips.
• Review flagged items before saving — it takes less than 10 seconds per paper.
• Scan one paper at a time. Don't stack sheets or have multiple sheets visible to the camera.

For quiz design

• Keep answer keys varied — a run of 5+ identical answers in a row (e.g., all A) is a common sign of a key entry error.
• Use the item analysis after each quiz to identify items with very high or very low difficulty — these often point to ambiguous questions or clerical errors in the key.
• A good item has a p-value between 0.30 and 0.70 and a discrimination index above 0.30 (Retain recommendation).
• Aim for an overall class average around 60–75% — consistently high averages may suggest the quiz is too easy.

For class management

• Import students from CSV at the start of the term — it's much faster than adding them one by one.
• Use the LRN field to prevent duplicates when importing from different sections.
• Link quizzes to the relevant class so results show up correctly in the class-level analytics.

When contacting support, please include: your account email, a description of the issue, the device and browser (or phone model) you're using, and any screenshots if possible. This helps us resolve your issue faster.