Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can add multimedia in the Form Builder, or you can add them in the Multimedia Manager

STEP 1: Adding a multimedia reference 

Inside the form builder, chose the question or label where you want an image to be displayed, or from which you want an audio file to be playable.

...

Images are automatically given the file type "png" and audio files "mp3"

 

STEP 2: Uploading Files

Note that it is not necessary that you use the Multimedia Manager for this.  If you prefer, you can manually name all of the media files, put them in the correct file paths, and load the files onto the phone.  However, we strongly suggest using the multimedia management tools built into CommCare as they minimize the risk of confusion around filenames.

Option 1: Form Builder

You can add files directly in the form builder, if you choose to. If you do that, you will be able to see the files you have uploaded when viewing the Multimedia Manager. To upload a file, simply click on "Upload Image/Video/Audio" button in the Media Section of Question Properties.

 

Option 2: Multimedia Manager - Manual Upload

Before you use the multimedia manager, make sure that you have followed Step 1 for all files that you want to upload. That means that for any question for which you want a media file, you should have added the reference in the form builder.

You can add files directly in the form builder, if you choose to. If you do that, you will be able to see the files you have uploaded when viewing the Multimedia Manager.You can find the Multimedia Manager for your application on the left-hand pane, just below the Settings link. After clicking on "Multimedia" you will see the following:

...

Again, you can see the number of missing files, and have the option to download a ZIP of all the multimedia files.  If your multimedia files are already correctly labeled, you can chose "Bulk Upload Multimedia" on the right side of the screen. This tool will help you to match all the files to the relevant references.  If the files are not yet labeled, you can click on either "Image References" or "Audio References" to individually upload files. 

Let's try uploading an image file.  If you have not yet uploaded any files, after clicking on "Image References" you will see something like this:

...

After you have uploaded the media file, your list will no longer have red "missing" tags, but green "found" tags.  It should look more like this:

Image RemovedImage Added

As you can see, your options from the Multimedia Manager have now changed.  You can preview the file by hovering your cursor over "Preview Image," or clicking on "Preview Image" to open the file in a new window (you'll have to open a new window to hear an uploaded audio file!).  If you want to change the image, click on "Replace Image" and follow the same instructions as before.  

 

Option 3: Multimedia Manager - Bulk Media Upload

If your multimedia files are already correctly labeled, you can chose "Bulk Upload Multimedia" on the right side of the screen. This tool will help you to match all the files to the relevant references. If the files are not yet labeled, you will need to use option 1 or 2 above.

STEP 3: Download Your Media Files!

Once you have uploaded all of your media files you can easily download all of them in one click, with all the correct file names.  You can choose to download the Media ZIP from several locations on CommCareHQ:

...