Form Uploader

This page has been deprecated.

See Form Uploader.

Use ODK Form Uploader to easily upload a blank form and its media files to ODK Aggregate.

Adding blank forms through the ODK Aggregate website is limited to an overall form-and-media size of 10MB; beyond that, you have to perform multiple uploads of the form definition file with different subsets of the media files in order to fully upload the blank form and its media attachments. If you have many media attachments or more than 10MB of media attachments, Form Uploader provides a quick and easy means to upload forms into ODK Aggregate.


  1. Make sure Java 7 or higher is installed on the computer you plan to use. If it is not, download and install it.
  2. Navigate to downloads/download-category/other/ and download ODK Form Uploader vN.N.N.jar.
  3. Double click the file to start. If that fails, try running 'java -jar path_to_jar' from the command line.


  1. Choose the form definition file (.xml) to upload.
  2. Specify the ODK Aggregate server. When specifying the ODK Aggregate server, either leave the username blank if the anonymousUser is granted Form Manager permissions, or specify an ODK Aggregate user (Account Type 'ODK') that has been granted Form Manager permissions. ODK Form Uploader does not work with Google accounts (Account Type 'Google').
  3. Click Upload Form.

ODK Form Uploader will look for a matching media directory and upload the form definition file and all media files to the ODK Aggregate server.

For example, when the form definition file is named myForm.xml, that form definition and all files in the matching media directory myForm-media will be uploaded. Note that the media directory should not contain any nested directories.

Useful Notes

  1. The developer wiki has release notes.