Agregar archivos multimedia a un XLSForm

Última actualización: 23 Apr 2026

KoboToolbox te permite agregar archivos multimedia, incluyendo imágenes, archivos de audio y videos, a notas, preguntas y opciones de tu formulario. Agregar archivos multimedia puede aumentar el compromiso de los usuarios y hacer que los formularios sean más accesibles para personas con discapacidades visuales o barreras de alfabetización.

Los archivos multimedia del formulario funcionan tanto con KoboCollect como con formularios web. Los siguientes tipos de archivos multimedia son compatibles actualmente:

Multimedia	Archivos
Imagen	jpeg, png, svg
Audio	aac, aacp, flac, mp3, mp4, mpeg, ogg, wav, webm, x-m4a, x-wav
Video	3gpp, avi, flv, mov, mp4, ogg, quicktime (qtff), webm, wmv

Este artículo cubre los siguientes temas:

• Agregar archivos multimedia a preguntas de la encuesta

• Agregar archivos multimedia a opciones de respuesta

• Agregar archivos multimedia a traducciones del formulario

• Cargar archivos multimedia a KoboToolbox

Nota: El editor de formularios de KoboToolbox (Formbuilder) no admite actualmente agregar archivos multimedia dentro de tus formularios. Para agregar archivos multimedia, debes usar XLSForm y luego cargarlo en KoboToolbox. Para obtener más información sobre cómo descargar y editar tu formulario como XLSForm, consulta Usar XLSForm con KoboToolbox.

Para practicar con la adición de archivos multimedia en XLSForm, consulta el curso XLSForm Fundamentals de la KoboToolbox Academy.

Agregar archivos multimedia a preguntas en XLSForm

Para agregar archivos multimedia a preguntas o notas en tu XLSForm:

1. Agrega una nueva pregunta en la hoja survey, especificando el type, name y label (opcional).

   • Utiliza un tipo de pregunta note si deseas mostrar el archivo multimedia sin recolectar datos (por ejemplo, el logotipo de una organización o un video de introducción).

   • Agregar una etiqueta es opcional cuando se incluye un archivo multimedia.

2. Agrega una columna para el tipo de multimedia que deseas incluir. Nómbrala image, video o audio, según el tipo de archivo multimedia.

3. En la columna de multimedia, en la fila de la pregunta que has agregado, ingresa el nombre exacto del archivo multimedia incluyendo la extensión.

   • Por ejemplo: logo.png o intro.mp4.

hoja survey

type	name	label	image
text	Q1	In your own words, how would you describe the image above?	q1.png
survey

Nota: Anteriormente, el formato media::file_type se usaba para los nombres de columnas de multimedia (por ejemplo, media::image, media::video, media::audio). El formato simplificado que usa solo el tipo de multimedia sin el prefijo media:: es ahora el más adoptado (por ejemplo, image, video, audio).

Cargar archivos multimedia a KoboToolbox

Para cargar los archivos multimedia a KoboToolbox:

1. Ve a tu cuenta de KoboToolbox.

2. En tu proyecto de KoboToolbox, navega a CONFIGURACIÓN > Multimedia.

3. Carga los archivos multimedia que has agregado a tu XLSForm, asegurándote de que el nombre del archivo sea exactamente el mismo.

4. Implementa o reimplementa tu formulario para ver los cambios en los archivos multimedia.

Para obtener más información sobre cómo cargar archivos multimedia, consulta Importar archivos multimedia a un proyecto.

Agregar archivos multimedia a opciones de respuesta en XLSForm

Para agregar archivos multimedia a opciones de respuesta en tu XLSForm:

1. Agrega una pregunta de tipo selección en la hoja survey.

2. En la hoja choices, agrega un list_name, name y label (opcional) para tus opciones.

   • Agregar una etiqueta es opcional cuando se incluye un archivo multimedia. Si deseas usar los archivos multimedia como etiqueta de las opciones, omite el texto de la etiqueta.

3. Agrega una columna para el tipo de multimedia que deseas incluir. Nómbrala image, video o audio, según el tipo de archivo multimedia.

4. En la columna de multimedia, en la fila de las opciones que has agregado, ingresa el nombre del archivo multimedia incluyendo la extensión.

   • Por ejemplo: goat.png o fish.png

hoja survey

name	type	label
select_one animals	animals	Which of these is your favorite animal?
survey

hoja choices

list_name	name	label	image
animals	goats	Goats	goat.png
animals	cows	Cows	cow.png
animals	chicken	Chickens	chicken.png
animals	pigs	Pigs	pig.png
animals	fish	Fish	fish.png
choices

Cargar archivos multimedia a KoboToolbox

Para cargar los archivos multimedia a KoboToolbox:

1. Ve a tu cuenta de KoboToolbox.

2. En tu proyecto de KoboToolbox, navega a CONFIGURACIÓN > Multimedia.

3. Carga los archivos multimedia que has agregado a tu XLSForm, asegurándote de que el nombre del archivo sea exactamente el mismo.

4. Implementa o reimplementa tu formulario para ver los cambios en los archivos multimedia.

Agregar archivos multimedia a traducciones

En los XLSForms que están traducidos a varios idiomas, puedes incluir diferentes archivos multimedia para cada idioma agregando nuevas columnas image, audio o video.

Para agregar archivos multimedia para diferentes idiomas en tu hoja survey:

1. Renombra tus columnas de multimedia usando el formato tipo_multimedia::idioma (código), donde tipo_multimedia es el tipo de archivo multimedia e idioma es el idioma predeterminado.

   • Por ejemplo: image::English (en)

2. Agrega una nueva columna de multimedia para cada idioma de traducción usando el formato tipo_multimedia::idioma (código).

   • Por ejemplo: audio::Spanish (es)

3. En la columna de multimedia para cada idioma, ingresa el nombre del archivo multimedia que deseas incluir, incluyendo la extensión.

   • Para usar el mismo archivo multimedia para cada idioma, ingresa el mismo nombre de archivo que el de la columna del idioma predeterminado.

Nota: Si un archivo multimedia no aparece en una columna de traducción, no se mostrará para ese idioma.

hoja survey

type	name	label	video::English (en)	video::Chichewa (ny)
note	intro	Before you answer the form, watch the video below:	intro.mp4	intro_ny.mp4
survey

Cargar archivos multimedia a KoboToolbox

Para cargar los archivos multimedia traducidos a KoboToolbox:

1. Ve a tu cuenta de KoboToolbox.

2. En tu proyecto de KoboToolbox, navega a CONFIGURACIÓN > Multimedia.

3. Carga los archivos multimedia que has agregado a tu XLSForm, asegurándote de que el nombre del archivo sea exactamente el mismo.

4. Implementa o reimplementa tu formulario para ver los cambios en los archivos multimedia.

Para obtener más información sobre cómo gestionar traducciones en XLSForm, consulta Añadir traducciones en XLSForm.

Resolución de problemas

Error al implementar o visualizar el formulario

Si encuentras un error al implementar o visualizar tu formulario, verifica lo siguiente:

• El archivo multimedia ha sido cargado en KoboToolbox en la pestaña Multimedia de la página CONFIGURACIÓN.
• El nombre del archivo en tu XLSForm coincide exactamente con el nombre y la extensión del archivo multimedia.

Los archivos multimedia no aparecen en el formulario implementado

Si los archivos multimedia no aparecen en tu formulario implementado, verifica lo siguiente:

• El archivo multimedia ha sido cargado en KoboToolbox en la pestaña Multimedia de la página CONFIGURACIÓN.
• El nombre del archivo en tu XLSForm coincide exactamente con el nombre y la extensión del archivo multimedia.
• El formulario ha sido reimplementado después de haber cargado los archivos multimedia.
• Has incluido archivos multimedia para cada traducción del formulario, si corresponde.

Cambiar el tamaño de un archivo multimedia

Para controlar el tamaño de las imágenes que se muestran en tus preguntas u opciones, debes cargar archivos multimedia con las dimensiones deseadas. Ten en cuenta que usar archivos muy grandes puede aumentar los tiempos de carga en los formularios web.

El formulario tarda mucho en cargar

Los formularios web cargarán lentamente si tus archivos multimedia son grandes. Reduce el tamaño de los archivos de imagen, video o audio antes de cargarlos al servidor para mejorar los tiempos de carga.

Cambiar la alineación de los archivos multimedia

Los archivos multimedia en los formularios de KoboToolbox están centrados de forma predeterminada, y no es posible personalizar la alineación (izquierda o derecha).

Los archivos GIF animados no son compatibles

Los archivos GIF animados no son compatibles actualmente ni con los formularios web ni con la aplicación Android KoboCollect.

No se puede cargar el archivo multimedia

El tamaño máximo para la carga de archivos multimedia es de 100 MB. Los archivos que superen este límite deben reducirse en tamaño antes de cargarlos.