Ajouter des médias à un XLSForm

Last updated: 23 Apr 2026

KoboToolbox vous permet d’ajouter des médias, notamment des images, des fichiers audio et des vidéos, aux notes, questions et choix de votre formulaire. L’ajout de médias peut accroître l’engagement des utilisateurs et rendre les formulaires plus accessibles aux personnes malvoyantes ou ayant des difficultés de lecture.

Les médias au sein du formulaire fonctionnent avec KoboCollect et les formulaires web. Les types de fichiers médias suivants sont actuellement disponibles :

Média

Fichiers

Image

jpeg, png, svg

Audio

aac, aacp, flac, mp3, mp4, mpeg, ogg, wav, webm, x-m4a, x-wav

Vidéo

3gpp, avi, flv, mov, mp4, ogg, quicktime (qtff), webm, wmv

Cet article couvre les sujets suivants :

  • Ajouter des médias aux questions du formulaire

  • Ajouter des médias aux choix de réponse

  • Ajouter des médias aux traductions du formulaire

  • Importer des fichiers médias dans KoboToolbox

Note : L'interface de création de formulaires KoboToolbox (KoboToolbox Formbuilder) ne permet pas d'ajouter des fichiers médias dans vos formulaires. Pour ajouter des médias, vous devez utiliser XLSForm, puis importer votre XLSForm dans KoboToolbox. Pour en savoir plus sur le téléchargement et la modification de votre formulaire en tant que XLSForm, consultez l'article Utiliser XLSForm avec KoboToolbox.

Pour un apprentissage pratique de l'ajout de fichiers médias dans XLSForm, consultez le cours XLSForm Fundamentals de la KoboToolbox Academy.

Ajouter des médias aux questions dans XLSForm

Pour ajouter des fichiers médias aux questions ou aux notes de votre XLSForm :

  1. Ajoutez une nouvelle question dans l”onglet survey, en précisant le type, le name et le label (facultatif).

    • Utilisez un type de question note si vous souhaitez afficher le fichier média sans collecter de données (par exemple, un logo d’organisation ou une vidéo d’introduction).

    • L’ajout d’un libellé est facultatif lorsqu’un fichier média est inclus.

  2. Ajoutez une colonne pour le média que vous souhaitez inclure. Nommez-la image, video ou audio, selon le type de média.

  3. Dans la colonne média, sur la ligne de la question que vous avez ajoutée, saisissez le nom exact du fichier média en incluant l’extension.

    • Par exemple : logo.png ou intro.mp4.

onglet survey

type

name

label

image

text

Q1

Dans vos propres mots, comment décririez-vous l’image ci-dessus ?

q1.png

survey

Note : Auparavant, le format media::file_type était utilisé pour les noms de colonnes médias (par exemple, media::image, media::video, media::audio). Le format simplifié utilisant uniquement le type de média sans le préfixe media:: est désormais plus couramment adopté (par exemple, image, video, audio).

Importer des fichiers médias dans KoboToolbox

Pour importer les fichiers médias dans KoboToolbox :

  1. Connectez-vous à votre compte KoboToolbox.

  2. Dans votre projet KoboToolbox, accédez à PARAMÈTRES > Média.

  3. Importez les fichiers médias que vous avez ajoutés à votre XLSForm, en vous assurant que le nom du fichier est exactement identique.

  4. Déployez ou redéployez votre formulaire pour voir les modifications apportées aux médias.

Importer des fichiers médias

Pour en savoir plus sur l'importation de fichiers médias, consultez l'article Importer des fichiers multimédias dans un projet.

Ajouter des médias aux choix de réponse dans XLSForm

Pour ajouter des fichiers médias aux choix de réponse de votre XLSForm :

  1. Ajoutez une question à choix multiple dans l”onglet survey.

  2. Dans l”onglet choices, ajoutez un list_name, un name et un label (facultatif) pour vos choix.

    • L’ajout d’un libellé est facultatif lorsqu’un fichier média est inclus. Si vous souhaitez utiliser les fichiers médias comme libellé des options, omettez le texte du libellé.

  3. Ajoutez une colonne pour le média que vous souhaitez inclure. Nommez-la image, video ou audio, selon le type de média.

  4. Dans la colonne média, sur la ligne des choix que vous avez ajoutés, saisissez le nom du fichier média en incluant l’extension.

    • Par exemple : goat.png ou fish.png

onglet survey

name

type

label

select_one animals

animals

Lequel de ces animaux préférez-vous ?

survey

onglet choices

list_name

name

label

image

animals

goats

Chèvres

goat.png

animals

cows

Vaches

cow.png

animals

chicken

Poulets

chicken.png

animals

pigs

Cochons

pig.png

animals

fish

Poissons

fish.png

choices

Importer des fichiers médias dans KoboToolbox

Pour importer les fichiers médias dans KoboToolbox :

  1. Connectez-vous à votre compte KoboToolbox.

  2. Dans votre projet KoboToolbox, accédez à PARAMÈTRES > Média.

  3. Importez les fichiers médias que vous avez ajoutés à votre XLSForm, en vous assurant que le nom du fichier est exactement identique.

  4. Déployez ou redéployez votre formulaire pour voir les modifications apportées aux médias.

Ajouter des médias aux traductions

Dans les XLSForms traduits en plusieurs langues, vous pouvez inclure différents fichiers médias pour chaque langue en ajoutant de nouvelles colonnes image, audio ou video.

Pour ajouter des fichiers médias pour différentes langues dans votre onglet survey :

  1. Renommez vos colonnes médias en utilisant le format type_media::langue (code), où type_media est le type de fichier média et langue est la langue par défaut.

    • Par exemple : image::English (en)

  2. Ajoutez une nouvelle colonne média pour chaque langue de traduction en utilisant le format type_media::langue (code).

    • Par exemple : audio::Spanish (es)

  3. Dans la colonne média pour chaque langue, saisissez le nom du fichier média que vous souhaitez inclure, en incluant l’extension.

    • Pour utiliser le même fichier média pour chaque langue, saisissez le même nom de fichier que celui figurant dans la colonne de la langue par défaut.

Note : Si un fichier média n'est pas renseigné dans une colonne de traduction, il ne sera pas affiché pour cette langue.

onglet survey

type

name

label

video::English (en)

video::Chichewa (ny)

note

intro

Avant de répondre au formulaire, regardez la vidéo ci-dessous :

intro.mp4

intro_ny.mp4

survey

Importer des fichiers médias dans KoboToolbox

Pour importer les fichiers médias traduits dans KoboToolbox :

  1. Connectez-vous à votre compte KoboToolbox.

  2. Dans votre projet KoboToolbox, accédez à PARAMÈTRES > Média.

  3. Importez les fichiers médias que vous avez ajoutés à votre XLSForm, en vous assurant que le nom du fichier est exactement identique.

  4. Déployez ou redéployez votre formulaire pour voir les modifications apportées aux médias.

Pour en savoir plus sur la gestion des traductions dans XLSForm, consultez l'article Ajouter des traductions dans XLSForm.

Résolution de problèmes

Erreur lors du déploiement ou de la visualisation du formulaire Si vous rencontrez une erreur lors du déploiement ou de la visualisation de votre formulaire, vérifiez les points suivants :
  • Le fichier média a été importé dans KoboToolbox via l'onglet Média de la page PARAMÈTRES.
  • Le nom du fichier dans votre XLSForm correspond exactement au nom et à l'extension du fichier média.

Les fichiers médias n'apparaissent pas dans le formulaire déployé Si les fichiers médias n'apparaissent pas dans votre formulaire déployé, vérifiez les points suivants :
  • Le fichier média a été importé dans KoboToolbox via l'onglet Média de la page PARAMÈTRES.
  • Le nom du fichier dans votre XLSForm correspond exactement au nom et à l'extension du fichier média.
  • Le formulaire a été redéployé depuis l'importation des fichiers médias.
  • Vous avez inclus des fichiers médias pour chaque traduction du formulaire, le cas échéant.

Modifier la taille d'un fichier média Pour contrôler la taille des images affichées dans vos questions ou choix, vous devez importer des fichiers médias avec les dimensions souhaitées. Notez que l'utilisation de fichiers très volumineux peut augmenter les temps de chargement dans les formulaires web.

Le formulaire met longtemps à se charger Les formulaires web se chargent lentement si vos fichiers médias sont volumineux. Réduisez la taille des fichiers image, vidéo ou audio avant de les importer sur le serveur afin d'améliorer les temps de chargement.

Modifier l'alignement des fichiers médias Les médias dans les formulaires KoboToolbox sont centrés par défaut, et un alignement personnalisé (à gauche ou à droite) n'est pas possible.

Les fichiers GIF animés ne sont pas pris en charge Les fichiers GIF animés ne fonctionnent actuellement ni avec les formulaires web ni avec l'application Android KoboCollect.

Impossible d'importer un fichier média La taille maximale pour l'importation de médias est de 100 Mo. Les fichiers dépassant cette limite doivent être réduits avant d'être importés.