Version 2.0.0 (September 2017)

The documentation on this page corresponds to Version 2.0.0 rev 214 (September 2017) of the tool suite. See Older Versions for documentation on earlier releases of this suite.

Release Designations

The ODK 2.0 tools are in various stages of release. Here is a description of the release designations

  • Alpha software does not have all features, and is more likely to have significant reductions or additions of functionality. Alpha releases are provided to gather user feedback on the usability and capabilities of the application, as well as bug reports (to make the application more robust). Updates may result in loss of data or incompatible changes in form designs.
  • Beta software does not have all features, but is less likely to have significant reductions or alterations in functionality. Beta releases are provided to gather user feedback on the usability and capabilities of the application, as well as bug reports (to make the application more robust). Updates may result in loss of data or incompatible changes in form designs.
  • NOTE: Alpha and Beta releases can be used as-is, but the ODK core team cannot provide support for deployments using them or guarantee a migration path into future releases. If you use these, you should plan to use them without expecting upgrades to newer versions of the tools. The ODK 2.0 tools have mechanisms to extract your data as CSV files from these tools, and to re-import data via CSV files. This provides a migration path to newer releases, but will generally require manual actions on your part.
  • Release Candidate software does not have support for deployments, but the ODK core team does guarantee a migration path (possibly with many tedious manual steps) into future releases.
  • Production software has been used in several deployments and there is some level of confidence that the software is stable. As with any software, there is no guarantee of being bug-free.

Non-technical users may find the usage descriptions difficult to follow and there may be a considerable number of manual steps needed to utilize the tools. As we progress from Alpha to Beta to Release Candidate and Production versions of the tools, they should become easier to use.


The next-generation ODK tools (the ODK 2.0 Tool Suite) are intended to address several limitations of the existing ODK Collect / ODK Aggregate / ODK Briefcase data collection workflow. These are:

  • Row-level access filters. Beginning with rev 206, the visibility of data and the ability to edit and/or delete data can be restricted for different users and user groups.
  • Fully customizable layout of prompts on the Android device. The 2.0 tools use HTML, JavaScript and CSS to specify the layout of nearly all the screens viewed by the data collectors. This enables individuals and organizations with basic web development skills to modify and customize the appearance of their surveys and workflow. At the same time, we retain the easy-to-use spreadsheet-based definition of the survey questions (however, this XLSX Converter mechanism is not cross-compatible with XLSForm).
  • More flexible, user-directed, navigation of a survey. The 2.0 tools do not impose a strict sequential advancement through a form like ODK Collect; form designers can allow users to traverse a form in any order, yet impose validation of collected data prior to traversing into subsequent steps in a workflow.
  • Improved treatment of repeat-groups. In the 2.0 tools, we have eliminated the concept of a repeat-group. In its place, we provide prompts that enable you to open and edit other surveys with links back to the originating survey (if desired). These prompts can describe a sub-form (nested) relationship among the surveys (e.g., household and household-member) or they can represent arbitrary relational linkages across your data (e.g., tea-houses and tea-types).
  • Bi-directional synchronization of data across devices. The ODK 2.0 tools support the collaborative sharing of survey data across devices, and the updating and submission of changes to previously-collected data (i.e., follow-up surveys) via a bi-directional synchronization protocol; this contrasts with the uni-directional device-to-server submission pathway of ODK Collect / ODK Aggregate / ODK Briefcase.
  • Data curation and visualization on the device. ODK Tables gives organizations the ability to investigate and visualize entire datasets directly on the Android devices through graphical and non-graphical displays and through filtered views.

The 2.0 Tool Suite consists of:

  1. ODK Application Designer 2.0.0 rev 214 - a design environment for creating, customizing, and previewing your forms, data curation, and visualization applications.
  2. ODK Survey v2.0.0 rev 214 - a data collection application based upon HTML, CSS, and JavaScript.
  3. ODK Tables v2.0.0 rev 214 - a data curation and visualization application running on your device.
  4. ODK Services v2.0.0 rev 214 - an application for handling database access, file access, and data synchronization services between all the ODK 2.0 applications. It allows you to synchronize data collected by the ODK 2.0 tools using the 2.0 protocol with an ODK Aggregate instance.
  5. ODK Cloud Endpoint v2.0.0 rev 214 - enhancements to support bi-directional data synchronization across disconnected devices.
  6. ODK Suitcase v2.0.0 rev 214 - a desktop tool for synchronizing data from an ODK 2.0 server so the data can be exported to CSV format.

Trying It Out

First, see the ODK Survey and ODK Tables pages. They cover setting up these tools (and ODK Services) as well as downloading and exploring demonstration forms and applications built upon these tools. These demonstration applications will give you a good sense of the flexibility and breadth of capabilities of the two tools.

Next, see the Getting Started Guide to understand the process for revising and developing your own forms. That guide will walk you through modifying the Geotagger demo app to add an additional field to it.

Finally, see the Permission Access Filters page for how to manage table and row-level access filters.

User-contributed Documentation

If you wish to contribute documentation or tutorials for the new tools, a Google doc has been started to hold user-contributed documentation here.

If you feel a section in that document is stable enough and complete enough to move onto the site, please contact us to coordinate the move.

Older Versions

Descriptions of older versions of the tools may be found here

2.x Release Version: