> 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/dashboard/customise.md).

# Customising your dashboard

Decide for yourself which widgets show, which comes first and how big it is.

**Go to:** **Dashboard** in the left menu, then **Customise** at the top right. The **Customise** button is in the same place on a phone. **Before you start:** nothing.

Your **layout** is which widgets show, in what order and how big. One layout is saved for each person and each role. When you change it, only your dashboard changes, nobody else's. What a widget is: [What the widgets mean](/schoolmanagerp-docs/en/dashboard/widgets.md).

[Customise the dashboard](#task-main) · [Reset to default](#task-reset) · [The school's dashboard settings](#task-settings) · [Monthly meeting report](#task-committee-report) · [Problems and fixes](#trouble)

**On this page**

* [How you get here](#arrive)
* [Customise the dashboard](#task-main)
* [How to know the layout was saved](#confirm)
* [Other situations](#other)
  * [Customising on a phone](#task-phone)
  * [With the keyboard only](#task-keyboard)
  * [Reset to default](#task-reset)
  * [The school's dashboard settings (admin)](#task-settings)
  * [Print the monthly meeting report](#task-committee-report)
* [Problems and fixes](#trouble)
* [Who can do what](#roles)
* [Learn more](#more)

***

## How you get here <a href="#arrive" id="arrive"></a>

**From the dashboard:** at the top right of [Seeing today's work on the dashboard](/schoolmanagerp-docs/en/dashboard/dashboard.md), press **Customise**. Start at step 1 below.

**If every widget is hidden:** the dashboard says **All widgets are hidden**, with a **Customise** button below. Press it; the same customise panel opens.

***

## Customise the dashboard <a href="#task-main" id="task-main"></a>

1. At the top right of the dashboard, press **Customise**.

   → **Customising** appears at the top, and the **Widgets** panel opens. The panel has two lists: **Shown** and **Hidden**. Beside it is a preview: **Preview: this is how it will look after saving**.

![the customise panel open, with the Shown and Hidden lists and the preview marked, admin](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-60c452cf9c58b22feff80b6271353545c876a938%2Fdashboard-02-customise.png?alt=media)

2. To hide a widget, untick the box on its row. To show it, tick the box.

   → The widget moves to the other list, and the preview changes.
3. To change the order, press the **↑** or **↓** button on the row. Only widgets in **Shown** can be moved. You cannot drag.

   → The widget moves one place up or down.
4. On a computer, to change the size, choose **Small**, **Medium** or **Large** from the size list on the row. If a widget has only one size, the list is greyed out.
5. When everything is right, press **Save** at the bottom.

   → The message **Dashboard saved** appears, and the dashboard returns with the new layout.

> **Keep in mind:** nothing changes until you press **Save**. If you press **Cancel**, everything stays as it was.

***

## How to know the layout was saved <a href="#confirm" id="confirm"></a>

| State                           | How you can tell                                                                   | What next       |
| ------------------------------- | ---------------------------------------------------------------------------------- | --------------- |
| **Changed on screen only**      | **Customising** at the top, and the new layout in the preview                      | Press **Save**. |
| **Reached the school's system** | The message **Dashboard saved**, and the panel closes and the dashboard comes back | Done.           |

This work is not kept on the device while offline; so there is no "saved on this device" state.

**To check it:** sign in on another computer or phone, with the same account and the same role. You will see the same layout.

![the dashboard back in its new layout after saving, with the Dashboard saved message marked, admin](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-545ee0f6586af2d5936644cdb34aaa29a1072619%2Fdashboard-04-saved.png?alt=media)

**If no message appears:** see [Problems and fixes](#trouble). If the panel is still open, you can press **Save** again.

***

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

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

On a phone, **Customise** opens the panel as a page that rises from the bottom, with a small bar at the top. Everything else is the same, except:

* You cannot change the size; size is only on a computer.
* A widget's short description is not shown, only its name.

<img src="https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-afe3b4a6d76b0c6c1c81ef6ff61f5be9017a385c%2Fdashboard-02-customise-phone.png?alt=media" alt="the customise panel as a bottom sheet on a phone, teacher" width="300">

### With the keyboard only <a href="#task-keyboard" id="task-keyboard"></a>

The panel says **Space to show or hide, Alt + ↑ / ↓ to move**.

| Key           | What it does   |
| ------------- | -------------- |
| `Space`       | Show / hide    |
| `Alt + ↑` `↓` | Move up / down |
| `Enter`       | Save           |
| `Esc`         | Cancel         |

A screen reader announces every change, for example "… is now at position 2".

### Reset to default <a href="#task-reset" id="task-reset"></a>

1. Open **Customise**.
2. At the bottom, press **Reset to default**. → The preview goes back to your role's starting layout. It is not saved yet.
3. Press **Save**. → **Dashboard saved**.

| You press            | What happens                                                | Saved?              |
| -------------------- | ----------------------------------------------------------- | ------------------- |
| **Reset to default** | The preview goes back to the role's starting layout         | No, not yet         |
| **Cancel**           | The panel closes, and your earlier saved layout stays       | No, nothing changes |
| **Save**             | The dashboard becomes like the preview, **Dashboard saved** | Yes                 |

### The school's dashboard settings (admin) <a href="#task-settings" id="task-settings"></a>

Some widgets follow limits that the school sets. These are for the whole school, and only an admin can change them.

1. Press **Settings** in the left menu, then **Academics** in the list on the left.
2. Scroll down to the **Dashboard** section.
3. Change the boxes (see the table below).
4. At the bottom of the section, press **Save**. → **Saved** appears.

**At-risk students:** a student shows in the **At-risk students** widget when any 2 of the 4 signs below match. The list changes a few minutes after you save.

| Box                                                         | What it means                                                                    | Starts at | What you can enter |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------- | --------- | ------------------ |
| **Absent in a row (days)**                                  | If a student has been absent this many days in a row or more                     | 3         | 1 to 30            |
| **Attendance in the last 30 days below (%)**                | If attendance in the last 30 days falls below this                               | 75        | 1 to 100           |
| **Failed subjects in the latest published exam (at least)** | If the student failed this many subjects or more in the latest published exam    | 1         | 1 to 20            |
| **Oldest unpaid bill older than (days)**                    | If the oldest unpaid bill is this many days past its due date or more            | 60        | 1 to 365           |
| **Attendance target (%)** (Committee section)               | Shows as a line on the committee's attendance chart                              | 90        | 1 to 100           |
| **Send at** (Morning summary section)                       | At what school time the morning summary goes out; it does not go out on holidays | 07:30     | Any time           |

If you enter something outside the limits, a message appears under the box, for example **Enter a whole number from 1 to 30.**

Turning the morning summary off for yourself: [Alerts and notifications → Morning summary](/schoolmanagerp-docs/en/dashboard/alerts.md#task-digest).

### Print the monthly meeting report <a href="#task-committee-report" id="task-committee-report"></a>

A one-page report of totals for this month, up to today, for the committee meeting.

1. As a committee member, press **Print monthly meeting report** at the top of the dashboard.

   → The **Monthly meeting report** page opens. Its sections are **Key numbers**, **Enrollment**, **Attendance**, **Collection and dues** and **Pass rate by class**. At the bottom it says **Totals only. No student, guardian or staff details are printed.**
2. Press **Print**.

   → The browser's own print box opens. Choose a printer and print, or choose "Save as PDF" as the destination to keep a file.
3. To go back, press **Back to dashboard**.

![the monthly meeting report page, with the Print and Back to dashboard buttons, the key numbers and the enrollment and attendance tables, committee member](https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-62d6ee37d1539c9c72511e2226f9c2571c6249bd%2Fdashboard-05-meeting-report.png?alt=media)

The numbers in the report always match the committee widgets on the dashboard, because both come from the same figures. Where there is no data, "—" is printed. The report is not emailed by itself and is not made on any fixed day; print it from here when you need it.

***

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

| What you see                                        | What to do                                                                   | Who can help |
| --------------------------------------------------- | ---------------------------------------------------------------------------- | ------------ |
| There is no size list                               | You are on a phone. Size only changes on a computer.                         | Yourself     |
| The size list is greyed out                         | This widget has only one size. It cannot be changed.                         | —            |
| The widget you want is not in the list              | It is not for your role, or you do not have permission to see it.            | Admin        |
| The layout is different when you switch role        | That is fine: each role's layout is saved separately.                        | Yourself     |
| **Enter a whole number from 1 to 30.**              | Type a whole number within the limits in the box, then press **Save** again. | Admin        |
| **The report could not load.**                      | Reload the page.                                                             | Admin        |
| There is no **Print monthly meeting report** button | The button only appears on the committee member's dashboard.                 | Admin        |

If a page or button is missing, see [Why can't I see this?](/schoolmanagerp-docs/en/help/cant-see-this.md).

***

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

| Role                                                                     | Customise their own dashboard | The school's dashboard settings | Monthly meeting report |
| ------------------------------------------------------------------------ | ----------------------------- | ------------------------------- | ---------------------- |
| Admin                                                                    | Yes                           | Yes                             | No                     |
| Academic coordinator, teacher, accountant, office staff, exam controller | Yes                           | No                              | No                     |
| Committee member                                                         | Yes                           | No                              | Yes                    |

***

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

<details>

<summary><strong>How customising works</strong> — from the panel to saving</summary>

<figure><img src="https://1521882729-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4VUIF0J625mjr4UQwChh%2Fuploads%2Fgit-blob-4116588a5140baff977a485a0501168598831214%2Fdashboard-customise.svg?alt=media" alt="Pressing Customise opens the customise panel; there you show, move and resize; pressing Save changes the dashboard for your role; pressing Cancel changes nothing" width="720"><figcaption><p><em>How customising works</em></p></figcaption></figure>

* One layout is saved for each person and each role; it is the same on every device.
* If the saved layout cannot be fetched, the role's starting layout is shown.
* If a new widget is added to your role's starting layout, you see it at the end even if you have your own layout.

</details>

**Related pages**

* [**Seeing today's work on the dashboard**](/schoolmanagerp-docs/en/dashboard/dashboard.md) — the page you are customising.
* [**What the widgets mean**](/schoolmanagerp-docs/en/dashboard/widgets.md) — read this before deciding which widgets to keep.
* [**Alerts and notifications**](/schoolmanagerp-docs/en/dashboard/alerts.md) — the morning summary and the alert settings.

***

*Version 0.1.0 · Last verified 2026-10-24*
