Students List
The Students List is the landing view of the Canvas tab. It shows every student in your organization with live status and the surah they’re currently reading.
Opening the List
Section titled “Opening the List”Click Canvas in the Studio navigation. The student list loads immediately — student status updates in real time without a refresh.
Status Indicators
Section titled “Status Indicators”Each student has a live status pulled from the Iqra WebSocket:
| Indicator | Meaning |
|---|---|
| 🟢 Online (green) | Student is connected but not in a reading session |
| 🔵 Active (blue) | Student is in a reading session |
| 🟠 Inactive (orange) | Student is connected but idle |
| 🔴 Offline (red) | Student is offline |
Each student’s avatar also carries a small corner dot — green when connected, red when offline.
Search
Section titled “Search”Use the search input at the top to find a student by username. The search is debounced — results appear automatically after you stop typing.
Filter by Status
Section titled “Filter by Status”Use the status dropdown to filter the list:
| Filter | Shows |
|---|---|
| All | Every student in the organization |
| Online | Only students who are connected but not in a reading session |
| Active | Only students currently in a reading session |
| Inactive | Only students who are connected but idle |
| Offline | Only students currently offline |
Grid vs List View
Section titled “Grid vs List View”Toggle between two layouts using the view button:
| View | Best for |
|---|---|
| List | Detailed scan — see name, username, current surah, and status side by side |
| Grid | Quick visual overview — student avatars and what they’re reading |
List View Columns
Section titled “List View Columns”| Column | Description |
|---|---|
| Name | Student’s display name with avatar |
| Username | Student’s email handle (before the @) |
| Surah Name | The surah they’re currently reading, plus reading mode (Read / Recite) |
| Status | Color-coded status dot with its label |
Click the column headers to sort by name or username (ascending or descending).
Grid View
Section titled “Grid View”Each student appears as a card with:
- Their profile photo with a green (online) or red (offline) corner dot
- Their name
- The surah they’re currently reading (or “Not reading”)
Pagination
Section titled “Pagination”The list is split into pages. Use the bar at the bottom to move between pages and to set Rows per page (10, 25, 50, 100 or 250).
Opening a Student
Section titled “Opening a Student”Click a student’s name or photo in either view to open their detail page. This loads the three-tab view: Quran, Stats, and Setting.
→ See Quran Tab, Stats Tab, and Setting Tab for what each tab does.
Loading Markdown…
Markdown could not load. or open the raw file.