> For the complete documentation index, see [llms.txt](https://schoolmanagerp.gitbook.io/schoolmanagerp-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://schoolmanagerp.gitbook.io/schoolmanagerp-docs/en/exam-templates/marks-entry.md).

# Entering and submitting exam marks

Enter the marks for your section and subject in an exam, and submit the marks list when you are done.

**Where to go:** in the left menu, **Exams & Results → Enter marks**. On a phone, press **☰** at the top left to open the menu, then follow the same path. It is not in the row of buttons at the bottom. **Before you start:** the Admin must have [created the exam](/schoolmanagerp-docs/en/exam-templates/exams.md) and set its subjects and mark parts. If you are a Teacher, you must be assigned as the **Subject teacher** for that subject in that section ([Teaching assignments](/schoolmanagerp-docs/en/students/teaching-assignments.md)).

This page is about the **marks list**. There is one marks list for each subject in each section of an exam, for example "Section A · Mathematics". Each row is a student, and each column is a mark part of the subject (for example written, multiple choice). A marks list is in one of two states: **Not submitted** (you can type marks) or **Submitted** (view only).

[Enter and submit marks](#task-main) · [Fill marks in Excel](#task-excel) · [Enter marks on a phone](#task-phone) · [Reopen a submitted list](#task-reopen) · [Problems and fixes](#trouble)

**On this page**

* [Enter and submit marks](#task-main)
* [Fill marks in Excel](#task-excel)
* [How to know the marks are saved and submitted](#confirm)
* [Other situations](#other)
  * [Enter marks on a phone](#task-phone)
  * [Reopen a submitted list (Admin only)](#task-reopen)
  * [Leaving the page before saving finishes](#task-leave)
  * [Open a list to view only](#task-view)
* [Problems and fixes](#trouble)
* [Who can do what](#roles)
* [Learn more](#more)

***

## Enter and submit marks <a href="#task-main" id="task-main"></a>

1. In the left menu press **Exams & Results**, then press **Enter marks**.

   → The **Marks entry** page opens. At the top it says how many of the marks lists have been submitted, for example "3 of 12 marks lists submitted".
2. In the **Exam** box, choose your exam. Each name looks like "Exam · Class". The first time, the first exam in the list is already chosen.

   → The marks lists appear below: **Section**, **Subject**, **Status**. The lists that are **Not submitted** come first. A Teacher sees only the lists where they can enter marks.

![Marks entry page, exam chosen, three marks lists below in the Not submitted state; 1 · Exam box 2 · Status filter 3 · Enter marks; teacher](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-7a1bd773ba5f4da9e559b1c6f9fecae0dbca7cbd%2Fmarks-entry-01-list.png?alt=media)

3. At the end of the row for the list you want, press **Enter marks**.

   → The **Marks list** opens. At the top are the subject, section, exam and the number of students, and below that **No changes yet**. The head of each column shows the full marks, for example **/ 50**.
4. Type the marks in the first student's cell. Decimals are fine, for example `34.5`. Bangla or English digits both work.

   → If you type more than the full marks, **max …** appears under the cell and that mark is not accepted.
5. Press **Enter**.

   → The cursor moves to the next student's cell in the same column. Finish one column from top to bottom this way.
6. If a student was absent, press **A** while in their cell. If a student is exempt from this part, press **E**.

   → The cell shows **Abs** or **Exm**. If you made a mistake, type a mark in that cell and it becomes a normal mark again.
7. The app saves by itself a moment after each mark you type. You do not have to do anything.

   → The line at the top first says **Saving…**, then **All changes saved ·** . A green tick appears beside the name of each student whose cells are all saved.
8. When every cell for every student is filled, press **Submit** at the top right. Or press **Ctrl+Enter** on the keyboard.

   → The **Submit this marks list?** window opens. If any cell is blank, a red line shows how many are blank, and **Submit** cannot be pressed.
9. In the window, press **Submit**.

   → The app first saves any remaining changes, then submits the list. The window closes, and next to the **Submitted** badge at the top it says **Submitted on . Only an admin can reopen it.** The cells can no longer be changed.

![A marks list after submitting: 1 the Submitted badge with the time and the line that only an admin can reopen it, 2 the marks cells](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-c574d6369c188216459c300da440f9feec9a91d7%2Fmarks-entry-04-submitted.png?alt=media)

| What you press in the window | What happens                                                                                   | Submitted? |
| ---------------------------- | ---------------------------------------------------------------------------------------------- | ---------- |
| **Submit**                   | Any remaining changes are saved, then the list is submitted and closed.                        | Yes        |
| **Cancel**                   | The window closes. The marks you typed stay as they were (they were already saved by the app). | No         |

> **Remember:** marks save by themselves, but the list is not submitted until you press **Submit**. If a list is still not submitted when the Admin goes to process the results, the Admin gets a warning ([Results](/schoolmanagerp-docs/en/exam-templates/results.md)).

***

## Fill marks in Excel <a href="#task-excel" id="task-excel"></a>

If you have many students, fill the marks in Excel and upload the file. The app checks the file first and shows you what will change. Nothing is saved until you press **Save**.

**Who can enter marks:** the **Subject teacher** of that subject, the **Admin**, and the **Exam controller**. The Exam controller is the backup when a teacher is away.

**When the teacher is away:** the Admin or Exam controller does not need to open the list first. In the **Enter marks** list each row has **Download sheet** and **Upload sheet** buttons. Press them there.

1. Open the marks list ([steps 1–3 above](#task-main)) and press **Download sheet**. → An Excel file is saved on your computer. It has two tabs: **Marks** and **How to fill**.

   ![Marks list with one mark typed: 1 · Download sheet button, next to Upload sheet and Submit](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-cf535967718481ae93e6ba810535f1e8fefb7917%2Fmarks-sheet-01-download.png?alt=media)
2. Open the file and fill **only the white cells**. Grey columns are worked out by the app; do not touch them. Write **A** if the student was absent, **E** if exempt. A blank cell means "keep the mark as it is".

   ![Fill marks in Excel page: 1 · step 2, Fill in the marks. You fill the file in Excel on your computer, so the app shows only this step](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-f1b376bd3a11a2ee104500da609a805c015b7aec%2Fmarks-sheet-02-fill.png?alt=media)
3. Go back to the app. In the marks list press **Upload sheet** and choose the file. The page shows three steps: **1. Download the sheet**, **2. Fill in the marks**, **3. Upload the sheet**. → The app reads the file.

   ![Fill marks in Excel page before a file is chosen: 1 · step 3, Upload the sheet 2 · the Choose file box](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-61a0f6663926a1cc8cac865bf676a039335f6234%2Fmarks-sheet-03-upload.png?alt=media)
4. Read the review. → It counts **new** marks, **changed** marks (for example `45 → 54`), **not changed**, **absent**, **exempt** and **errors**. Check the changed marks carefully.

   ![Review after the upload: 1 · counts 1 new, 1 changed, 0 not changed, 1 errors 2 · a changed mark, Written: 45.00 → 54.00 3 · the error row, Above full marks; Save 2 at the bottom](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-1254f5acaa30beeb6e29601cde2ed9564bd8d696%2Fmarks-sheet-04-review.png?alt=media)
5. Press **Save**. → The button shows how many marks it will save. A message says how many marks were saved. If an error row exists, only the good rows are saved.

   ![After pressing Save: 1 · the message 2 marks saved](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-3e26d05af2ce9271c141daaa9c678844748a1dca%2Fmarks-sheet-05-saved.png?alt=media)
6. Fix each error row in the grid: press **Close**, type the correct mark in that cell. Each error says what is wrong, for example "Above full marks" or "This student is not in this section".

   ![Marks list after Close: 1 · the error row's cell with the correct mark typed 2 · the All changes saved line](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-dbb9e25250ddcd29538154826f71b319759591ad%2Fmarks-sheet-06-fix.png?alt=media)
7. When every cell is filled, press **Submit** as usual ([step 8 above](#task-main)).

   ![Marks list with every cell filled: 1 · Submit button](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-a6361ef53bef83ddb5b6e9077b5dd6f3d0c57cbf%2Fmarks-sheet-07-submit.png?alt=media)

| Write in the cell       | Meaning                                        |
| ----------------------- | ---------------------------------------------- |
| A mark, e.g. `34.5`     | That mark. Bangla or English digits both work. |
| **A** (also AB, অ, অনু) | Absent                                         |
| **E** (also EX, ছাড়)   | Exempt                                         |
| blank                   | Keep the mark already in the app               |

> **Remember:** if the list is **Submitted**, you cannot upload a sheet. The Admin must [reopen it](#task-reopen) first. If many people press upload at once or the service is busy, wait a few minutes and try again.

***

## How to know the marks are saved and submitted <a href="#confirm" id="confirm"></a>

Marks are not kept separately on your phone or computer. If the internet is down, the app keeps trying to send them, but if you close the page, marks that were not sent are lost. So there is no "saved on this device" state here.

| State                           | How you know                                                                                                         | What next                                           |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| **Changed on screen only**      | **Saving…** in the line at the top, or in red **… changes not saved — retrying**; a coloured outline around the cell | Wait and check your internet; do not leave the page |
| **Reached the school's system** | **All changes saved ·** and a green tick beside the name                                                             | When every cell is done, press **Submit**           |
| **Submitted**                   | The **Submitted** badge and **Submitted on . Only an admin can reopen it.**                                          | Done                                                |

**To check:** leave the page, then open the same list again from **Enter marks**. If your marks show in the cells, they are in the system. After you submit, the submitted count at the top goes up by one.

**If no message appears:** see [Problems and fixes](#trouble). If you keep the page open, marks that are not yet saved are not deleted.

***

## Other situations <a href="#other" id="other"></a>

### Enter marks on a phone <a href="#task-phone" id="task-phone"></a>

On a small screen like a phone, the marks list shows one student at a time.

1. Do steps 1–3 above in the same way.

   → One student's name, and below it a cell for each mark part. At the top are **Previous**, "**… of …**" and **Next**.
2. Type the marks in each cell. If the student was absent, press **Absent** beside the cell. If exempt, press **Exempt**.
3. Press **Next** to go to the next student.
4. At the very end, press **Submit** at the top, then press **Submit** again in the window.

   → The **Submitted** badge appears, as on a computer.

<img src="https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-9f99e7446ba37162784a5f47650a2537593d154e%2Fmarks-entry-05-phone.png?alt=media" alt="The marks list on a phone: one student, Absent and Exempt buttons beside the cell, Previous and Next above the card" width="300">

On a phone, **A**, **E** and **Ctrl+Enter** do not work; use the buttons.

### Reopen a submitted list (Admin only) <a href="#task-reopen" id="task-reopen"></a>

If a mistake is found after a Teacher has submitted, only an Admin can reopen the list.

1. As the Admin, open the submitted marks list (from [the exam's page](/schoolmanagerp-docs/en/exam-templates/exams.md), or press **View marks** if it is in the **Enter marks** list).
2. In the row with the **Submitted** badge, press **Reopen**.

   → No window appears. The list goes back to **Not submitted**, and the cells can be typed in again.
3. The Teacher corrects the marks and presses **Submit** again.

If the results are **Published**, the list cannot be reopened. First [reopen the results](/schoolmanagerp-docs/en/exam-templates/results.md#task-reopen). If the results are **Processed**, changing marks in a reopened list recalculates the whole exam's results by itself.

### Leaving the page before saving finishes <a href="#task-leave" id="task-leave"></a>

If some marks are not saved yet and you try to go to another page inside the app, the **Leave without saving?** window appears.

| What you press   | What happens                                            | Saved?                    |
| ---------------- | ------------------------------------------------------- | ------------------------- |
| **Stay**         | You stay on the page; the app keeps trying to save.     | In a moment               |
| **Leave anyway** | You leave the page. Marks that were not saved are lost. | No, only the unsent marks |

### Open a list to view only <a href="#task-view" id="task-view"></a>

The Academic coordinator can view marks but cannot type them. In the coordinator's list each row ends with **View marks**. In the open list the cells are grey and there is no **Submit** button. The Exam controller is different: they can type and submit marks too, as a backup when the teacher is absent.

***

## Problems and fixes <a href="#trouble" id="trouble"></a>

| What you see                                                                                                  | What to do                                                                                                                                       | Who can help                                                                             |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| **No exams yet**                                                                                              | They will appear here once the Admin [creates an exam](/schoolmanagerp-docs/en/exam-templates/exams.md).                                         | Admin                                                                                    |
| **No marks lists yet**                                                                                        | The exam's subjects and mark parts are not set, or you are not assigned to any subject in this exam.                                             | Admin ([Teaching assignments](/schoolmanagerp-docs/en/students/teaching-assignments.md)) |
| A section or subject is missing from your list                                                                | A Teacher sees only the lists where they are the **Subject teacher** for that subject. Being the class teacher is not enough to enter marks.     | Admin ([Teaching assignments](/schoolmanagerp-docs/en/students/teaching-assignments.md)) |
| **Nothing matches**                                                                                           | Press **Clear all** to clear the search and filter.                                                                                              | —                                                                                        |
| **Couldn't load marks lists.**                                                                                | Check your internet and try again.                                                                                                               | Admin                                                                                    |
| **max …**                                                                                                     | You cannot type more than the full marks. Type the correct mark.                                                                                 | —                                                                                        |
| **… changes not saved — retrying**                                                                            | Check your internet and keep the page open. The app tries again by itself, and sends again as soon as you type something new.                    | —                                                                                        |
| **… blank cells must be filled first. Enter a mark, A (absent) or E (exempt).**                               | Put a mark, **A** or **E** in each blank cell. A blank row for a student who joined late or does not take this subject does not stop the submit. | —                                                                                        |
| **Couldn't submit this marks list. Please try again.**                                                        | Check your internet and press **Submit** again. If the results were published in the meantime, it can no longer be submitted; tell the Admin.    | Admin ([Results](/schoolmanagerp-docs/en/exam-templates/results.md))                     |
| Saving keeps failing, and someone else submitted the list or the results were published while you had it open | When a list or an exam is closed, new marks are not accepted. Reload the page to see the state.                                                  | Admin                                                                                    |
| **Couldn't reopen this marks list. Please try again.**                                                        | Check your internet. If the results are published, first [reopen the results](/schoolmanagerp-docs/en/exam-templates/results.md#task-reopen).    | Admin                                                                                    |
| You do not see the **Submit** or **Reopen** button                                                            | See [Who can do what](#roles).                                                                                                                   | Admin                                                                                    |

***

## Who can do what <a href="#roles" id="roles"></a>

| Role                                       | Which lists they see                                                                                                                        | Enter and submit marks                             | Reopen a submitted list            |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------- |
| Admin                                      | All in the school                                                                                                                           | Yes, in every list                                 | Yes (if results are not published) |
| Teacher                                    | Only where they are the Subject teacher for that subject, in the current academic year (also a draft exam for a class of the previous year) | Yes, only in those lists                           | No                                 |
| Exam controller                            | All in the school                                                                                                                           | Yes, in every list (backup when a teacher is away) | No                                 |
| Academic coordinator                       | All in the school                                                                                                                           | No, view only                                      | No                                 |
| Accountant, Office staff, Committee member | **Enter marks** is not in their menu                                                                                                        | No                                                 | No                                 |

If a Teacher opens the address of a list in another section directly, the app shows it as "not found", as if the list did not exist.

***

## Learn more <a href="#more" id="more"></a>

<details>

<summary><strong>Parts of the page</strong> — the marks list, top to bottom</summary>

1. **Marks list** — the heading; below it subject · section · exam · number of students.
2. **Saving line** — **No changes yet**, **Saving…** or **All changes saved ·** .
3. **Submit** — at the top right; it appears only on a list that is not submitted and only if you may enter marks.
4. **Keyboard help line** — just above the list.
5. **The list** — **Roll · Name**, then each mark part. Grey columns are worked out by the app (for example from attendance); you cannot type in them.

![the five parts of the marks list marked with numbers, teacher](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-7a1bd773ba5f4da9e559b1c6f9fecae0dbca7cbd%2Fmarks-entry-01-list.png?alt=media)

</details>

<details>

<summary><strong>Keyboard shortcuts</strong></summary>

| Key            | What it does                                        |
| -------------- | --------------------------------------------------- |
| **Enter**      | Moves to the next student's cell in the same column |
| **↑ ↓ ← →**    | Moves up, down, left, right                         |
| **Tab**        | Moves to the next cell along the row                |
| **A**          | Absent (**Abs**)                                    |
| **E**          | Exempt (**Exm**)                                    |
| **Ctrl+Enter** | Opens the **Submit this marks list?** window        |

On a Mac you can press **⌘** instead of **Ctrl**.

</details>

<details>

<summary><strong>What each field means</strong></summary>

| Field     | What to enter                                                                    | Required?                                      |
| --------- | -------------------------------------------------------------------------------- | ---------------------------------------------- |
| Exam      | Which exam you are entering marks for.                                           | Yes                                            |
| Search    | Part of a section or subject name. Only the Admin sees it.                       | No                                             |
| Status    | **All**, **Not submitted** or **Submitted**.                                     | No                                             |
| Mark cell | From 0 up to the full marks, decimals allowed; **A** if absent, **E** if exempt. | Yes — the list cannot be submitted while blank |

**What happens in the calculation:** if a student is absent in any part of a subject, the whole subject counts as **Absent** and the subject is failed. An exempt part is left out of both the marks obtained and the full marks. If a part has a pass mark set, getting less than it fails the whole subject. More in [Results](/schoolmanagerp-docs/en/exam-templates/results.md#more).

</details>

<details>

<summary><strong>How marks entry works</strong> — from the exam to the list, then the results</summary>

<figure><img src="https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-23c4aa118339f31150e4ceaf3cc1c2f37b4eba4c%2Fexams-results-marks-entry-overview.svg?alt=media" alt="From the exam to a marks list for each section and subject; marks are typed while the list is not submitted, pressing Submit makes it submitted; the Admin can reopen it; once submitted, the results are processed" width="720"><figcaption><p><em>A marks list from submission to results</em></p></figcaption></figure>

* Every section and subject of every exam has one marks list. The columns come from the [exam's mark parts](/schoolmanagerp-docs/en/exam-templates/exams.md).
* Almost as soon as you type (in under a second), the app sends the marks together; if that fails, it tries again every little while.
* When every list is submitted, the Admin or the Exam controller processes the [results](/schoolmanagerp-docs/en/exam-templates/results.md). The [grading scale](/schoolmanagerp-docs/en/exam-templates/grading-scales.md) decides which grade the results get.

</details>

<details>

<summary><strong>Short help for the boxes (the (?) button)</strong></summary>

| Field                                   | What to enter                                                                                                                              | Required?                                     |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| Name (exam)                             | The exam name, e.g. Half Yearly 2026. Two exams of the same class and year cannot share a name.                                            | Yes                                           |
| Kind (exam)                             | Term, monthly, model or other. Cannot change once results are published.                                                                   | No                                            |
| Mark entry deadline                     | Teachers see the days left on their dashboard. Leave empty if there is none.                                                               | No                                            |
| Academic year                           | The year the exam belongs to. Chosen only when you add the exam.                                                                           | Yes                                           |
| Class                                   | The class that sits the exam. Pick the year first; it cannot change later.                                                                 | Yes                                           |
| Start from an exam structure (optional) | Pick an exam structure and the parts for the class subjects are made for you. Hidden when there is no structure.                           | No                                            |
| Name (part)                             | The part name, e.g. Written. Two parts of one subject cannot share a name.                                                                 | Yes                                           |
| Kind (part)                             | Written, MCQ, viva, practical and so on. Attendance is counted for you.                                                                    | No                                            |
| Full marks                              | The full marks of the part, e.g. 70; a positive number. Not shown for an attendance part.                                                  | Yes, except attendance parts                  |
| Pass marks                              | The pass mark of the part, e.g. 23. Not more than the full marks. Leave empty if not needed.                                               | No                                            |
| Exam (marks entry)                      | The exam you are entering marks for. Its marks lists for the sections and subjects you may enter show below.                               | Yes                                           |
| Marks (marks entry)                     | The marks for that student and part, up to the maximum shown. Type A for absent and E for exempt. Attendance parts are worked out for you. | Yes, the list cannot be submitted while blank |
| By part (analysis)                      | On the Pass/fail tab, tick it to see the results for each part of a subject, not only for the whole subject.                               | No                                            |

</details>

**Related pages**

* [**Processing and publishing results**](/schoolmanagerp-docs/en/exam-templates/results.md) — the results are built from the submitted marks.
* [**Setting up grading scales**](/schoolmanagerp-docs/en/exam-templates/grading-scales.md) — which percentage gets which grade is set here.
* [**Teaching assignments**](/schoolmanagerp-docs/en/students/teaching-assignments.md) — which Teacher enters marks for which subject in which section.
* [**Creating and setting up exams**](/schoolmanagerp-docs/en/exam-templates/exams.md) — the lists and their columns come from here.
* [**Merit list and result analysis**](/schoolmanagerp-docs/en/exam-templates/analysis.md) — See an exam's merit list, the students who failed or were absent and the pass/fail by subject, filter by section, print or download a CSV.

***

*Version 0.1.0 · last verified 2026-10-25*
