> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equinos.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de estudiantes

> Consulta, busca, filtra, importa y exporta los estudiantes de tu escuela desde la lista de Estudiantes.

La página de **Estudiantes** reúne a todas las personas que toman clases en tu escuela. Desde aquí puedes buscarlas, filtrarlas, registrar estudiantes nuevos, importar una lista desde Excel y descargar la lista.

## Abrir la lista

En el menú lateral, ve a **Académico** → **Estudiantes**.

## Indicadores

En la parte superior verás:

| Indicador | Qué muestra |
| - | - |
| **Total registrados** | Estudiantes que coinciden con los filtros actuales |
| **Activos ahora** | Estudiantes con estado **Activo** |
| **En prueba** | Estudiantes que tomaron o van a tomar una clase de prueba |
| **Avanzados / profesionales** | Estudiantes con nivel **Avanzado** o **Profesional** |
| **Nuevos este mes** | Estudiantes registrados en el mes actual |

<Note>
  **Activos ahora**, **Avanzados / profesionales** y **Nuevos este mes** se refieren a los estudiantes que se muestran en pantalla. Úsalos como referencia rápida.
</Note>

## Buscar y filtrar

En el bloque **Directorio** tienes:

* **Búsqueda**: escribe un nombre, un código (por ejemplo, `EST-0012`) o un email.
* **Nivel**: **Todos los niveles**, **Principiante**, **Intermedio**, **Avanzado** o **Profesional**.
* **Estado**: **Todos**, **Activos**, **En prueba**, **Inactivos**, **Suspendidos** o **Graduados**.

Al abrir la página, el filtro de estado muestra solo los **Activos**. Cámbialo a **Todos** para ver a todos los estudiantes.

<Tip>
  La lista muestra hasta 20 estudiantes a la vez. Si tienes más, usa la búsqueda o los filtros para encontrar a quien necesitas.
</Tip>

## Columnas de la lista

* **Estudiante**: foto, nombre y email o teléfono.
* **Código**: código automático del estudiante (`EST-0001`, `EST-0002`…).
* **Nivel**: Principiante, Intermedio, Avanzado o Profesional.
* **Clases**: número de inscripciones del estudiante.
* **Estado**: Activo, Prueba, Inactivo, Suspendido o Graduado.

Haz clic en cualquier fila para abrir el [detalle del estudiante](/escuelas/estudiantes/detalle-estudiante).

## Estados del estudiante

| Estado | Significado |
| - | - |
| **Activo** | Toma clases normalmente |
| **Prueba** | Tomó o va a tomar una clase de prueba |
| **Inactivo** | Ya no viene a clases |
| **Suspendido** | Suspendido temporalmente |
| **Graduado** | Terminó su formación |

El estado es informativo: cambiarlo no cancela las inscripciones del estudiante. Si un estudiante deja de venir, cancela también sus inscripciones en el programa.

### Convertir un estudiante de prueba

Los estudiantes que registras como asistentes de prueba desde **Asistencia** quedan con estado **Prueba**. Cuando decidan quedarse:

1. Filtra por **En prueba**.
2. En la columna **Estado**, haz clic en **Convertir**.
3. El estudiante pasa a **Activo** y verás el mensaje **Estudiante convertido a activo**.

## Botones de la página

* **Nuevo estudiante**: abre el formulario de registro. Ver [crear un estudiante](/escuelas/estudiantes/crear-estudiante).
* **Importar**: carga muchos estudiantes desde un archivo Excel o CSV. Ver [importar estudiantes](/escuelas/estudiantes/importar-csv).
* **Exportar**: descarga un archivo Excel (`estudiantes_<fecha>.xlsx`) con los estudiantes.

Si no ves estos botones, tu rol no tiene permiso para crear o exportar estudiantes. Pide acceso al propietario de la escuela.

## Exportar la lista

1. Ajusta los filtros de **Nivel** y **Estado** según lo que quieras descargar.
2. Haz clic en **Exportar**.
3. Se descarga un archivo Excel con los estudiantes que cumplen esos filtros.

<Note>
  La exportación incluye a los estudiantes de todas las sedes que cumplen los filtros de **Nivel** y **Estado**.
</Note>

## Próximos pasos

* [Crear un estudiante](/escuelas/estudiantes/crear-estudiante)
* [Importar estudiantes desde Excel o CSV](/escuelas/estudiantes/importar-csv)
* [Ver el detalle del estudiante](/escuelas/estudiantes/detalle-estudiante)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.