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

# Importaciones

> Importa datos masivos a tus colecciones desde archivos CSV o XLSX

La función de importación te permite cargar datos masivos a tus colecciones desde archivos **CSV** o **XLSX** (Excel). Puedes importar datos a una colección existente o crear una nueva colección durante el proceso.

<Frame caption="Sección de importaciones de Databases">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/imports.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=48da8b652294743341dfdc81dab4da4c" alt="Página de importaciones con botón New Import y estado vacío indicando que no hay importaciones" width="3024" height="1730" data-path="assets/images/datum/imports.png" />
</Frame>

## Importar a una colección existente

Haz clic en el ícono de importación en la barra lateral izquierda y luego en **+ New Import** para abrir el asistente.

<Frame caption="Asistente de importación: selección de colección y carga de archivo">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/import-wizard.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=604cd039bea9ef98d61a0d7202a7ae63" alt="Asistente de importación mostrando paso 1 con opciones Use Existing y Create New, selector de colección y zona de carga de archivos" width="3024" height="1730" data-path="assets/images/datum/import-wizard.png" />
</Frame>

El asistente tiene **5 pasos**:

<Steps>
  <Step title="Upload File">
    Asegúrate de que **Use Existing** esté seleccionado, elige la colección destino del dropdown y arrastra tu archivo CSV o XLSX a la zona de carga (o haz clic para seleccionarlo).

    <Note>
      Tamaño máximo de archivo: **500 MB**. Formatos soportados: **CSV** y **XLSX**.
    </Note>
  </Step>

  <Step title="Review Mappings">
    Asocia cada campo de la colección con una columna del archivo CSV. El asistente detecta coincidencias automáticamente (ej. un campo `email` se mapea solo). Para cada campo puedes seleccionar un **Subtype** (General Text, ID Number) y un **Country** cuando aplique. Las columnas del CSV que no mapees aparecerán en la sección **Unused CSV columns** y serán ignoradas.
  </Step>

  <Step title="Configure Options">
    Opcionalmente activa **Enable duplicate detection** para que Databases verifique registros existentes y evite duplicados durante la importación.
  </Step>

  <Step title="Preview Data">
    Revisa una previsualización de las primeras filas. Verás contadores de filas válidas, errores y duplicados. Haz clic en cualquier fila para ver el detalle del error.
  </Step>

  <Step title="Review & Confirm">
    Revisa el resumen final con los detalles del archivo, la colección destino, los mapeos de columnas y los campos omitidos. Haz clic en **Start Import** para ejecutar la importación.
  </Step>
</Steps>

## Importar creando una nueva colección

<Steps>
  <Step title="Upload File">
    Haz clic en **+ New Import**, selecciona **Create New**, ingresa el nombre de la nueva colección y sube tu archivo CSV o XLSX.
  </Step>

  <Step title="Define Fields">
    Databases inferirá los tipos de campo automáticamente a partir de las columnas del archivo. Puedes ajustar los tipos manualmente si es necesario.
  </Step>

  <Step title="Configure Options">
    Opcionalmente activa la detección de duplicados.
  </Step>

  <Step title="Preview Data">
    Revisa la previsualización de filas y verifica que los datos y tipos sean correctos.
  </Step>

  <Step title="Review & Confirm">
    Revisa el resumen final y haz clic en **Start Import**.
  </Step>
</Steps>

## Historial de importaciones

Todas las importaciones realizadas se muestran en la sección de Importaciones con su estado. Desde aquí puedes monitorear el progreso de importaciones en curso y revisar el resultado de importaciones anteriores.