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 |
|---|---|
| 🟢 Green dot | Student is online and actively reading or reciting |
| 🟡 Yellow dot | Student is online but not in an active reading session |
| 🔴 Red dot | Student is offline |
The card or row background also reflects the online/offline state — online students have a colored border around their avatar; offline students appear dimmed.
Search
Section titled “Search”Use the search input at the top to find a student by name. 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 currently online |
| 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 |
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 an online/offline ring
- Their name
- The surah they’re currently reading (or “Not reading”)
Pagination
Section titled “Pagination”The list paginates automatically as you scroll — additional students load as you reach the bottom. There’s no need to click a “next page” button.
Opening a Student
Section titled “Opening a Student”Click any student 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.