Collecting data using KoboCollect

Last updated: 23 Apr 2026

KoboCollect is a free, open-source KoboToolbox app designed for data collection on mobile devices. It is best suited for field teams of enumerators using Android phones or tablets, especially when data needs to be collected offline.

Before getting started, you will need to install and configure the KoboCollect app. Once set up, KoboCollect allows you to fill and submit forms from your mobile device, even offline.

This article explains how to use KoboCollect for data collection, including downloading forms, completing and editing submissions, sending finalized forms, deleting saved or blank forms, and troubleshooting common issues.

For more information about the KoboCollect app and recommended devices, see Setting up the KoboCollect app.

Downloading forms

To begin data collection with KoboCollect, you will need to download the KoboToolbox form(s) to your device. Before downloading, ensure you have:

  • At least one deployed form in your KoboToolbox account (either owned by or shared with you).

  • A project (account) set up on KoboCollect.

  • An internet connection on your device.

To download forms to your device:

  • From the main menu, click Download form.

  • Select the form(s) you wish to download individually by tapping the checkbox next to each form, or tap Select All to download all deployed forms.

  • Tap Get Selected.

Downloaded forms will appear when you click on Start new form from the app main menu.

Note: You will need to repeat this process any time an update is made to the form or form media. If you anticipate frequent form updates or are using dynamic data attachments, we recommend enabling automatic form downloads.

Collecting data

Once forms are downloaded, you can begin data collection. Note that once you have downloaded the form(s) in the app, you do not need an internet connection to collect data.

  1. From the main menu, tap Start new form.

  2. Select the form you wish to collect data with.

  3. To change the form language, tap the three dots icon in the top right corner of the screen and click Change Language.

  4. Navigate through questions by swiping left or clicking NEXT after answering.

  5. At the end of the survey, you can choose to Save as draft, Finalize, or Send the form (depending on your project settings).

Option

Description

Save as draft    

The form will be saved to Drafts and can still be edited before finalizing.

Finalize

The form will be saved to Ready to send and can no longer be edited. This option appears only if the Auto send setting is set to Off.

Send

The form will be sent to the server directly or queued until an internet connection is available. It can no longer be edited. This option appears only if the Auto send setting is enabled.

By default, forms and data remain on the device until manually deleted. If you enable Delete after send in the project settings, forms will be deleted automatically once they have been submitted to the server.

Editing drafts

If you saved a survey as a draft, you can edit it before sending it to the server:

  1. From the main menu, select Drafts.

  2. A list of saved draft forms will appear. Select the one you want to edit.

  3. Make the necessary changes, then tap Finalize or Send, depending on your workflow.

Note: You do not need an internet connection to edit a saved form in KoboCollect.

Sending finalized forms to the server

After finalizing your forms, you must upload them to the KoboToolbox server. Forms are often completed and finalized offline, then uploaded in bulk once an internet connection is available. To send your forms to the KoboToolbox server:

  1. Ensure the device has a secure internet connection.

  2. From the main menu, tap Ready to send. A list of finalized forms will appear.

  3. Tap Select All, or manually select the forms you want to upload by ticking the checkbox.

  4. Tap Send Selected to submit the forms to the server.

To verify successful upload, go to the main menu and select Sent. You will see all forms sent to the server, along with their synchronization date.

Note: If your project is set to automatically send finalized forms, the Ready to send page will not appear in the main menu, and you can skip these steps. For more information on project settings in KoboCollect, see Customizing KoboCollect settings.

Deleting saved forms and blank forms

After finalizing data collection and uploading all completed forms to the server, you may want to delete remaining form data from the KoboCollect app, unless automatic deletion is already enabled for your device. This helps protect data privacy and prevents confusion when collecting data for a new project.

There are two types of forms that can be deleted:

To delete forms:

  1. From the main menu, tap Delete form. You will see two tabs.

  2. Under Saved Forms:

    • Tap Select All to delete all saved forms, or select individual forms.

    • Tap Delete Selected.

  3. Under Blank Forms:

    • Tap Select All to delete all blank forms, or select individual forms.

    • Tap Delete Selected.

Note: You do not need an internet connection to delete forms in KoboCollect. However, if blank forms are accidentally deleted offline, an internet connection is required to recover them for continued data collection. To prevent accidental deletion, you can set access controls in the project settings.

Troubleshooting

Download form takes too long to load If the Download form page takes a long time to connect to the server or load downloadable forms, your KoboToolbox account may have too many active forms, or your internet connection may be weak.

Try the following:
  • Archive forms that are no longer in use to reduce the number of forms KoboCollect needs to load.
  • Check that your internet connection is stable, then try again.

KoboCollect shows an old version of the form If KoboCollect shows an older version of your form, download the form again to get the latest deployed version. You can also enable automatic form updates in KoboCollect so the app checks for newer versions when connecting to the server.

Error evaluating field […] XPath evaluation: type mismatch. This field is repeated This error means that your form is using dynamic data attachments, and that the field used to link the parent and child data contains duplicate values in the parent data. The linking field must contain only unique values.

To fix this, remove or correct the duplicate values in the linking field of the parent data, or use the [position() = 1] argument in your calculation.

Error getting form list If you see “Error getting form list” after opening Download form, first check that the KoboToolbox server URL in KoboCollect is correct. A small typo in the URL is a common cause of this error.

Also make sure the device is connected to the internet. In some cases, the device may appear connected to Wi-Fi but still require you to sign in through a browser before internet access is available.

Secure connection errors You may see an error such as “Generic Exception: No peer certificate”, “Form listing failed”, or SSLPeerUnverifiedException when KoboCollect cannot establish a secure connection to the server.

The most common cause is that the device date is incorrect. Check the date and time settings on the phone or tablet, then try again. This can happen if the device battery was fully drained and the date reset.

This error can also appear when using a Wi-Fi network or hotspot that requires a browser sign-in before allowing internet access.

Unable to edit this blank form because the corresponding blank form is not present or was deleted This error appears when you try to edit a saved form, but the original blank form is no longer available on the device. 

To fix this, download the blank form again. After that, you should be able to reopen and continue editing the saved form.

No internet access at all If field devices cannot access the internet at any point, KoboCollect submissions can still be transferred manually from the device to a computer using external tools and a USB connection. In more advanced setups, it is also possible to run KoboToolbox locally on a computer and connect devices to it over a local network without internet access.

These approaches are less common and require additional setup, so they are usually best suited for specialized workflows.