diff --git a/source/alternative_enketo.md b/source/alternative_enketo.md index 830e59cb2..6d47ca0bf 100644 --- a/source/alternative_enketo.md +++ b/source/alternative_enketo.md @@ -1,15 +1,15 @@ -# Styling Enketo web forms in the Formbuilder +# Styling web forms in the Formbuilder **Last updated:** 21 Mar 2026 -You can customize the layout and visual appearance of your [Enketo web forms](https://support.kobotoolbox.org/enketo.html) using built-in themes. These themes allow you to control how questions are displayed, whether on a single page, across multiple pages, or arranged in a compact grid layout. +You can customize the layout and visual appearance of your [web forms](https://support.kobotoolbox.org/data_through_webforms.html) using built-in themes. These themes allow you to control how questions are displayed, whether on a single page, across multiple pages, or arranged in a compact grid layout. -Form themes apply only to Enketo web forms and are not supported in KoboCollect. This article explains how to apply an Enketo theme in the Formbuilder and how to configure question widths when using the Grid theme. +Form themes apply only to web forms and are not supported in KoboCollect. This article explains how to apply a web form theme in the Formbuilder and how to configure question widths when using the Grid theme. -## Adding an Enketo theme in the Formbuilder +## Adding a web form theme in the Formbuilder -To add an Enketo theme to your form in the Formbuilder: +To add a web form theme to your form in the Formbuilder: 1. Click **Layout & Settings** in the top right corner of the screen. 2. In the **Form style** section, select the theme you want to apply to your form. @@ -26,7 +26,7 @@ The following themes are available to customize your forms: ## Setting up question widths for the Grid theme -In Enketo web forms, the Grid theme allows you to display questions in multiple columns, making your form more compact and visually organized. The setup of these columns, including how many there are and how wide each one should be, is controlled by assigning `w-values` to each question in its **Appearance (Advanced)** settings. +In web forms, the Grid theme allows you to display questions in multiple columns, making your form more compact and visually organized. The setup of these columns, including how many there are and how wide each one should be, is controlled by assigning `w-values` to each question in its **Appearance (Advanced)** settings.

For a comprehensive overview of using the Grid theme, see this Grid Theme Tutorial and sample XLSForm. diff --git a/source/appearances_xls.md b/source/appearances_xls.md index 356aa36c6..06905dac1 100644 --- a/source/appearances_xls.md +++ b/source/appearances_xls.md @@ -3,7 +3,7 @@ Question appearances allow you to customize how questions are displayed in the form and the type of responses they collect. This article explains how to add question appearances in XLSForm and lists common appearances by question type. -It is important to note that some appearances only work in [Enketo web forms](https://support.kobotoolbox.org/enketo.html), while others are supported only in [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html). Consider your data collection method when selecting appearances. +It is important to note that some appearances only work in [web forms](https://support.kobotoolbox.org/data_through_webforms.html), while others are supported only in [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html). Consider your data collection method when selecting appearances.

Note: This article focuses on setting question appearances in XLSForm. To learn about setting appearances in the KoboToolbox Formbuilder, see Using the Formbuilder documentation. @@ -28,24 +28,24 @@ To add question appearances in XLSForm: ## Available question appearances in XLSForm -The tables below list common question appearances by question type and shows which are supported in Enketo web forms and KoboCollect. +The tables below list common question appearances by question type and shows which are supported in web forms and KoboCollect. ### Select question types Select questions allow respondents to [choose from predefined options](https://support.kobotoolbox.org/question_types_xls.html#select-question-types). | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `minimal` | Displays choices in a drop-down menu. | Enketo and KoboCollect | -| `compact` | Displays choices side-by-side with minimal padding and without choice boxes. | Enketo and KoboCollect | -| `label` | Displays choice labels without the choice boxes. | Enketo and KoboCollect | -| `list-nolabel` | Displays the answer choice boxes without the labels. | Enketo and KoboCollect | -| `autocomplete` | Adds a search bar at the top of the option list. | Enketo and KoboCollect (combine with `minimal` appearance) | -| `likert` | Displays answer choices as a Likert scale (`select_one` only). | Enketo and KoboCollect | -| `horizontal` | Displays choices in evenly sized columns, with the same number of choices in each row. | Enketo only. Use `columns` instead for compatibility with KoboCollect. | -| `columns` | Displays choices in evenly sized columns, with the same number of choices in each row. | Enketo and KoboCollect | -| `horizontal-compact` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label. | Enketo only. Use `columns-pack` instead for compatibility with KoboCollect. | -| `columns-pack` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label. | Enketo and KoboCollect | -| `columns-n` | Displays available choices in the specified number (n) of columns. | Enketo and KoboCollect | +| `minimal` | Displays choices in a drop-down menu. | Web forms and KoboCollect | +| `compact` | Displays choices side-by-side with minimal padding and without choice boxes. | Web forms and KoboCollect | +| `label` | Displays choice labels without the choice boxes. | Web forms and KoboCollect | +| `list-nolabel` | Displays the answer choice boxes without the labels. | Web forms and KoboCollect | +| `autocomplete` | Adds a search bar at the top of the option list. | Web forms and KoboCollect (combine with `minimal` appearance) | +| `likert` | Displays answer choices as a Likert scale (`select_one` only). | Web forms and KoboCollect | +| `horizontal` | Displays choices in evenly sized columns, with the same number of choices in each row. | Web forms only. Use `columns` instead for compatibility with KoboCollect. | +| `columns` | Displays choices in evenly sized columns, with the same number of choices in each row. | Web forms and KoboCollect | +| `horizontal-compact` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label. | Web forms only. Use `columns-pack` instead for compatibility with KoboCollect. | +| `columns-pack` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label. | Web forms and KoboCollect | +| `columns-n` | Displays available choices in the specified number (n) of columns. | Web forms and KoboCollect | | `quick` | Auto-advances the form to the next question after an answer is selected (`select_one` only). | KoboCollect only | | `quickcompact` | Displays choices side-by-side with minimal padding and without choice boxes, and auto-advances to the next question after an answer is selected (`select_one` only). | KoboCollect only | | `map` | Displays a map to select options from. Requires defining GPS coordinates in the `choices` sheet (`select_one` only). | KoboCollect only | @@ -60,7 +60,7 @@ Numeric questions are used to [collect whole numbers or decimal numbers](https:/ | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `thousands-sep` | Formats large numbers using a comma separator for thousands. | Enketo and KoboCollect | +| `thousands-sep` | Formats large numbers using a comma separator for thousands. | Web forms and KoboCollect | | `bearing` | Records a compass reading in degrees (`decimal` only), if the device is equipped with an accelerometer or magnetic field sensor. | KoboCollect only | | `counter` | Displays buttons for increasing and decreasing digits (`integer` only). | KoboCollect only | @@ -70,10 +70,10 @@ Range questions are used to [select values within a specified range](https://sup | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `vertical` | Changes the orientation of the number line to a vertical line. | Enketo and KoboCollect | -| `picker` | In KoboCollect, displays a pop-up spinner for selecting values. In Enketo, displays a drop-down menu. | Enketo and KoboCollect | -| `rating` | Displays stars instead of a number line. | Enketo and KoboCollect | -| `distress` | Displays a thermometer instead of a number line. | Enketo only | +| `vertical` | Changes the orientation of the number line to a vertical line. | Web forms and KoboCollect | +| `picker` | In KoboCollect, displays a pop-up spinner for selecting values. In web forms, displays a drop-down menu. | Web forms and KoboCollect | +| `rating` | Displays stars instead of a number line. | Web forms and KoboCollect | +| `distress` | Displays a thermometer instead of a number line. | Web forms only | ### Text question type @@ -82,8 +82,8 @@ Text questions allow users to [collect open-ended responses](https://support.kob | Appearance | Description | Compatibility | | :--- | :--- | :--- | | `numbers` | Displays a numeric keyboard instead of a text keyboard (e.g., to collect phone numbers). | KoboCollect only | -| `multiline` | Displays a larger text box for longer text responses. | Enketo and KoboCollect | -| `url` | Displays a clickable URL under the question text and makes the question read-only. Requires entering a URL in the question's `default` column, or in the `calculation` column if the URL includes dynamic values. Also works with `note` questions. | Enketo and KoboCollect | +| `multiline` | Displays a larger text box for longer text responses. | Web forms and KoboCollect | +| `url` | Displays a clickable URL under the question text and makes the question read-only. Requires entering a URL in the question's `default` column, or in the `calculation` column if the URL includes dynamic values. Also works with `note` questions. | Web forms and KoboCollect | | `masked` | Masks text entered by the respondent (e.g., a password or confidential information). | KoboCollect only | @@ -92,8 +92,8 @@ Date questions are used to [capture specific calendar dates](https://support.kob | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `month-year` | Captures a month and a year. | Enketo and KoboCollect | -| `year` | Captures only a year. | Enketo and KoboCollect | +| `month-year` | Captures a month and a year. | Web forms and KoboCollect | +| `year` | Captures only a year. | Web forms and KoboCollect | | `no-calendar` | Displays a spinner to select the day, month, and year, instead of the default calendar-style picker. | KoboCollect only | | `coptic` | Displays the Coptic calendar. | KoboCollect only | | `ethiopian` | Displays the Ethiopian calendar. | KoboCollect only | @@ -109,9 +109,9 @@ GPS questions are used to [capture the geographic coordinates](https://support.k | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `maps` | Displays a map for users to visualize the location that is being automatically recorded (`geopoint` only). | KoboCollect only (included in default Enketo appearance) | -| `placement-map` | Allows for manual selection of a location on a map (`geopoint` only). | KoboCollect only (included in default Enketo appearance) | -| `hide-input` | Shows a larger map and hides other input fields (latitude, longitude, altitude, accuracy). | Enketo only | +| `maps` | Displays a map for users to visualize the location that is being automatically recorded (`geopoint` only). | KoboCollect only (included in default web form appearance) | +| `placement-map` | Allows for manual selection of a location on a map (`geopoint` only). | KoboCollect only (included in default web form appearance) | +| `hide-input` | Shows a larger map and hides other input fields (latitude, longitude, altitude, accuracy). | Web forms only | ### Image question type @@ -119,9 +119,9 @@ Image questions allow users to [upload or record images](https://support.kobotoo | Appearance | Description | Compatibility | | :--- | :--- | :--- | -| `signature` | Allows users to draw their signature. | Enketo and KoboCollect | -| `draw` | Allows users to sketch or create drawings. | Enketo and KoboCollect | -| `annotate` | Allows users to annotate an image by drawing or writing on it. | Enketo and KoboCollect | +| `signature` | Allows users to draw their signature. | Web forms and KoboCollect | +| `draw` | Allows users to sketch or create drawings. | Web forms and KoboCollect | +| `annotate` | Allows users to annotate an image by drawing or writing on it. | Web forms and KoboCollect | | `new` | Prompts users to take a new picture using the device camera (no file upload). | KoboCollect only | | `new-front` | Prompts users to take a new picture using the device's front-facing camera. | KoboCollect only | diff --git a/source/calculations_xls.md b/source/calculations_xls.md index 77dee19a1..464d379cd 100644 --- a/source/calculations_xls.md +++ b/source/calculations_xls.md @@ -136,7 +136,7 @@ To set a dynamic default response:

Division by zero - If a calculation includes a division and the divisor is equal to zero, the result is handled differently in Enketo and KoboCollect. In Enketo, a division by zero is ignored. In KoboCollect, the calculated value will be Infinity, which can cause issues in data reports and when processing exported data. To prevent this, add skip logic so the calculation does not run when the divisor equals zero, or apply a constraint to prevent the divisor variable from being equal to zero. + If a calculation includes a division and the divisor is equal to zero, the result is handled differently in web forms and KoboCollect. In web forms, a division by zero is ignored. In KoboCollect, the calculated value will be Infinity, which can cause issues in data reports and when processing exported data. To prevent this, add skip logic so the calculation does not run when the divisor equals zero, or apply a constraint to prevent the divisor variable from being equal to zero.

diff --git a/source/collecting_data_multiple_languages.md b/source/collecting_data_multiple_languages.md index d53078882..db05255fa 100644 --- a/source/collecting_data_multiple_languages.md +++ b/source/collecting_data_multiple_languages.md @@ -3,9 +3,9 @@ KoboToolbox supports collecting data in **as many languages as you need** within a single form, including languages that use non-Latin scripts. You can design your form with multiple translations, allow respondents to switch to their preferred language during data collection, and later view or export the data in any form language. -Adding translations to a single form removes the need for creating separate forms for each language, making it easier to manage multilingual projects and **keep your data consistent across languages.** Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [Enketo web forms](https://support.kobotoolbox.org/enketo.html) support form translations. +Adding translations to a single form removes the need for creating separate forms for each language, making it easier to manage multilingual projects and **keep your data consistent across languages.** Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [web forms](https://support.kobotoolbox.org/data_through_webforms.html) support form translations. -This article provides an overview of the different options for preparing forms with translations, how to collect data in multiple languages (including setting up language-specific links for Enketo web forms), and how to manage and export multilingual data in KoboToolbox. +This article provides an overview of the different options for preparing forms with translations, how to collect data in multiple languages (including setting up language-specific links for web forms), and how to manage and export multilingual data in KoboToolbox. ## Setting up your forms with translations @@ -33,7 +33,7 @@ Most elements displayed to respondents can be translated. These include **questi When your form contains translations, respondents can choose their preferred language during data collection and switch languages at any time before submitting their responses. -To change the form language in Enketo web forms: +To change the form language in web forms: 1. Open the form in your browser. 2. In the top right corner of the form, a **Choose Language** dropdown menu is displayed (only in forms with multiple languages). @@ -56,7 +56,7 @@ By default, form links copied from KoboToolbox open in the form’s default lang 3. Share the language-specific URL with respondents.

- Note: This overrides both the browser language setting and the form’s default language. This functionality applies only to Enketo web forms, not KoboCollect. + Note: This overrides both the browser language setting and the form’s default language. This functionality applies only to web forms, not KoboCollect.

## Managing data in multiple languages diff --git a/source/data-offline.md b/source/data-offline.md deleted file mode 100644 index 7e4cbd390..000000000 --- a/source/data-offline.md +++ /dev/null @@ -1,44 +0,0 @@ -# Collecting Data Offline -**Last updated:** 24 Sep 2025 - - -**All data collection can take place offline, both with KoboCollect and with Web -Forms.** - -When a user enters data it is stored first on the device. KoboCollect [can be set](https://support.kobotoolbox.org/kobocollect_settings.html#form-management-settings) to attempt sending the information through a network connection immediately or -only at a later stage when the interviewer or supervisor wants to upload -finalized forms. Web Forms will always attempt to upload data immediately and -will retry until a connection has been established again. - -All synchronization is proofed even against poor Internet connection quality. -Should a connection time out or be interrupted while a specific form is being -transferred, it will be resent with the next upload attempt. The server will not -integrate half received data in this case. Only when a record has been uploaded -successfully and the server confirms receipt will the survey data be removed -from the upload queue. - -Web Forms uses the browser's HTML5 offline storage to store survey responses as -well as the form itself. It is important to wait for the small confirmation -message in the top-right on the form, which will show a green checkmark once the -form has been cached. After this the form can be accessed and data can be -entered even without any connection. It is recommended to create a bookmark on -the device to easily access specific forms - -## What do I do if I have NO access to the internet? - -If it is not possible to connect a handset to the Internet at all (the -interviewers can't move into an area where a connection is available), then it -is also possible to transfer survey data from KoboCollect through an external -tool [ODK Briefcase](https://docs.getodk.org/briefcase-intro)) and by connecting -the mobile devices by USB cable to a local computer. For more details about how -to use ODK Briefcase to transfer data, -[read this post](https://blog.cartong.org/2016/03/11/migration-odk-platforms). -After this is it possible to upload the survey data from a centralized computer -to the KoboToolbox server, using the same tool. - -Finally, it is also possible to install KoboToolbox on a local computer, e.g. a -laptop, and then connect local mobile devices through a local WiFi to the -computer. This WiFi does not need to be connected to the Internet as there would -be a direct connection between the mobile devices and the local computer. -[See here](https://github.com/kobotoolbox/kobo-install) to find out how to install KoboToolbox on -your computer. diff --git a/source/data_collection_kobocollect.md b/source/data_collection_kobocollect.md index 6238e1736..5a5527651 100644 --- a/source/data_collection_kobocollect.md +++ b/source/data_collection_kobocollect.md @@ -1,4 +1,4 @@ -# Data collection using KoboCollect +# Collecting data using KoboCollect **Last updated:** 30 Dec 2025 diff --git a/source/date_time.md b/source/date_time.md index 0e7873eb6..9f62983b3 100644 --- a/source/date_time.md +++ b/source/date_time.md @@ -30,7 +30,7 @@ To add date and time questions to your form: The table below displays the default appearances for date and time questions: -![Date time questions in Enketo vs KoboCollect](images/date_time/table.png) +![Date time questions in web forms vs KoboCollect](images/date_time/table.png) ### Advanced appearances diff --git a/source/devices_for_data_collection.md b/source/devices_for_data_collection.md deleted file mode 100644 index 92dadc7bd..000000000 --- a/source/devices_for_data_collection.md +++ /dev/null @@ -1,51 +0,0 @@ -# Recommended Devices for Data Collection -**Last updated:** 20 Nov 2025 - -KoboCollect works on any Android phone or tablet running Android 5.1 or higher. Starting in 2026, Android 8.0 or higher will be required for new app versions. The last available version for older devices will still be available in the Play Store and on [GitHub](https://github.com/kobotoolbox/collect/releases). - -Web forms will run on any device, including Apple iOS devices and laptops. This article is -about choosing the right mobile device for field data collection and applies to -both Android devices and non-Android devices. - -Recommending devices for field data collection is difficult due to the large -number of available devices, each with different features and advantages. When -choosing a device you need to weigh the importance of screen quality, -durability, battery capacity, camera (consider whether you'll need front-facing, -back-facing, or both), internal storage and memory, internal sensors (GPS, -movement), connectivity options (WiFi, cellular, BlueTooth, ...), weight, etc. - -

- To learn more about connecting KoboCollect to your KoboToolbox account, configuring KoboCollect settings, and collecting data with the app, see Getting started with KoboCollect, Customizing KoboCollect settings and Data collection using KoboCollect. -

- -## Phones vs. Tablets - -An important choice early on is whether to choose a phone or a tablet. Phones -have the advantage of also having cellular data connectivity, which a lot of -tablets don't support. This allows synchronizing data while cell phone service -is available and not depending on WiFi networks. Cell phone service is not an -option in many remote field settings, of course, though this may be attractive -when working in urban locations or areas with high cell phone service coverage. - -In general, try to achieve a good balance between acceptable pricing and -choosing devices that can be re-used in the field for multiple deployments. The -same reasoning as for choosing other IT equipment should apply. - -When choosing a cell phone, ensure that the chosen model supports the -frequencies available in the country of deployment. Choosing phones that are -unlocked and that use multiple frequencies (quad band) are ideal for this -purpose. - -## Pricing - -Mobile devices for field data collection do not have to be expensive and it is -not necessary or recommended to choose latest-generation phones or tablets -(which often range above $400 for tablets and over $600 for phones). These -devices tend to be equipped with all the latest technology which means that they -will not be outdated technologically for a long time. However, their high costs -also makes them a bigger inventory risk for potential theft or damages. - -Likewise, it is best not to choose among the lowest tier of devices from -little-known manufacturers or fake brands (available for less than $100), often -sold in emerging markets. These devices may present serious drawbacks in terms -of their durability which can negatively impact data collection. diff --git a/source/dynamic_data_attachment.md b/source/dynamic_data_attachment.md index f3b7408d6..d244029fb 100644 --- a/source/dynamic_data_attachment.md +++ b/source/dynamic_data_attachment.md @@ -131,7 +131,7 @@ It is possible for a parent and child project to be the same project. The steps ## Collecting and managing data with dynamic linking -Data for dynamically linked projects can be collected using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [Enketo web forms](https://support.kobotoolbox.org/data_through_webforms.html). +Data for dynamically linked projects can be collected using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [web forms](https://support.kobotoolbox.org/data_through_webforms.html). When collecting data, note the following: diff --git a/source/dynamic_data_attachment_formbuilder.md b/source/dynamic_data_attachment_formbuilder.md index f0a91f39f..04b36f324 100644 --- a/source/dynamic_data_attachment_formbuilder.md +++ b/source/dynamic_data_attachment_formbuilder.md @@ -104,7 +104,7 @@ It is possible for a parent and child project to be the same project. The steps ## Collecting and managing data with dynamic linking -Data for dynamically linked projects can be collected using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [Enketo web forms](https://support.kobotoolbox.org/data_through_webforms.html). +Data for dynamically linked projects can be collected using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [web forms](https://support.kobotoolbox.org/data_through_webforms.html). When collecting data, note the following: diff --git a/source/editing_deleting_data.md b/source/editing_deleting_data.md index 136394a5d..ebd2ccf11 100644 --- a/source/editing_deleting_data.md +++ b/source/editing_deleting_data.md @@ -1,7 +1,7 @@ # Editing and deleting your data **Last updated:** 10 Feb 2026 -Editing and deleting data helps **maintain data quality** after submissions are collected. You may need to correct individual responses, update multiple records at once, duplicate a submission, or remove records that are no longer needed. KoboToolbox offers several ways to manage these tasks, including **editing submissions in Enketo, editing raw data directly, and applying bulk updates.** This article explains each method and when to use it. +Editing and deleting data helps **maintain data quality** after submissions are collected. You may need to correct individual responses, update multiple records at once, duplicate a submission, or remove records that are no longer needed. KoboToolbox offers several ways to manage these tasks, including **editing submissions via web form, editing raw data directly, and applying bulk updates.** This article explains each method and when to use it.

Note: Submissions collected with the KoboCollect app cannot be edited or deleted in KoboCollect after they are submitted. All post-submission changes must be made in KoboToolbox. @@ -19,7 +19,7 @@ KoboToolbox offers two editing approaches, each designed for different use cases The two methods for editing submissions in KoboToolbox are: -- **Editing submissions in Enketo:** Opens the submission in [Enketo](https://support.kobotoolbox.org/glossary.html#enketo-web-forms) so you can correct responses and resubmit the form. This method is recommended when form logic needs to be applied. +- **Editing submissions via web form:** Opens the submission as a [web form](https://support.kobotoolbox.org/glossary.html#enketo-web-forms) so you can correct responses and resubmit the form. This method is recommended when form logic needs to be applied. - **Editing raw data directly in KoboToolbox:** Opens a data editor that lets you modify specific responses directly. This method is recommended when you need precise control over edits and do not need form logic to apply. Each method comes with its advantages and limitations: @@ -27,16 +27,16 @@ Each method comes with its advantages and limitations: ![Editing data](images/editing_deleting_data/table.png)

-Note: When editing data using either method, the _uuid metadata field is updated each time a change is saved. When editing in Enketo, the end field is also updated. All other metadata fields remain unchanged, including _id, start, today, _submission_time, and _submitted_by. +Note: When editing data using either method, the _uuid metadata field is updated each time a change is saved. When editing via web form, the end field is also updated. All other metadata fields remain unchanged, including _id, start, today, _submission_time, and _submitted_by.

-### Editing submissions in Enketo +### Editing submissions via web form -This method opens a submission in Enketo so you can correct responses. +This method opens a submission as a web form so you can correct responses. -To edit a submission in Enketo: +To edit a submission via web form: -1. In the submission row, next to the checkbox, click **Edit.** The submission opens in an [Enketo web form](https://support.kobotoolbox.org/glossary.html#enketo-web-forms). +1. In the submission row, next to the checkbox, click **Edit.** The submission opens as a [web form](https://support.kobotoolbox.org/glossary.html#enketo-web-forms). 2. Make the necessary changes. 3. Click **Submit.** @@ -50,7 +50,7 @@ All updates, including recalculated fields and updated metadata, appear in the d ### Editing raw data in KoboToolbox -This method lets you bypass form logic and edit stored responses directly without reopening the form. It is useful when changes cannot be made in Enketo, for example, if form logic prevents resubmission or newly required questions need responses. +This method lets you bypass form logic and edit stored responses directly without reopening the form. It is useful when changes cannot be made via web form, for example, if form logic prevents resubmission or newly required questions need responses. To edit raw data in KoboToolbox: @@ -135,15 +135,15 @@ There is no dedicated option to delete a single field value. Instead, you can cl ## Troubleshooting
- Editing in Enketo modifies or removes data - When you reopen complex forms in Enketo, fields affected by skip logic, calculations, or dynamic data attachments may change. These behaviors can prevent the form from being resubmitted or remove data that no longer meets logic conditions. If you cannot resubmit the form, you can exit the Enketo form and no changes will be saved. To avoid these effects, edit the raw data directly instead. + Editing via web form modifies or removes data + When you reopen complex forms as a web form, fields affected by skip logic, calculations, or dynamic data attachments may change. These behaviors can prevent the form from being resubmitted or remove data that no longer meets logic conditions. If you cannot resubmit the form, you can exit the web form and no changes will be saved. To avoid these effects, edit the raw data directly instead.

- Editing in Enketo after new questions are added - If you edit an older submission in Enketo after updating and redeploying the form, the submission opens in the latest version of the form. This can cause issues when new required questions have been added, because you must provide valid responses to those questions in order to save your edits to the original submission. + Editing via web form after new questions are added + If you edit an older submission via web form after updating and redeploying the form, the submission opens in the latest version of the form. This can cause issues when new required questions have been added, because you must provide valid responses to those questions in order to save your edits to the original submission.

@@ -158,10 +158,10 @@ To resolve this, uncheck Include fields from all versions in th
- Self-intersecting geoshapes block edits in Enketo - KoboCollect may record self-intersecting geoshapes when GPS coordinates fluctuate while a data collector is standing still. These polygons can be submitted successfully from KoboCollect, but reopening the same submission in Enketo may trigger a geometry error. Enketo does not allow the form to be saved until the polygon is corrected, which can be difficult to fix manually. + Self-intersecting geoshapes block edits in web forms + KoboCollect may record self-intersecting geoshapes when GPS coordinates fluctuate while a data collector is standing still. These polygons can be submitted successfully from KoboCollect, but reopening the same submission via web form may trigger a geometry error. Web forms do not allow the form to be saved until the polygon is corrected, which can be difficult to fix manually.

-In this situation, use raw data editing in KoboToolbox to update the required fields without reopening the submission in Enketo. This avoids the geometry validation error. +In this situation, use raw data editing in KoboToolbox to update the required fields without reopening the submission via web form. This avoids the geometry validation error.

@@ -175,8 +175,8 @@ If any part is missing or incorrectly formatted, the edit may not save or may ca
- Form using dynamic data attachments to prevent duplicate submissions cannot be edited in Enketo - If your form uses dynamic data attachments to prevent duplicate submissions, reopening a submission in Enketo will block resubmission because it is detected as a duplicate. In this case, use raw data editing in KoboToolbox instead of editing in Enketo. + Form using dynamic data attachments to prevent duplicate submissions cannot be edited via web form + If your form uses dynamic data attachments to prevent duplicate submissions, reopening a submission via web form will block resubmission because it is detected as a duplicate. In this case, use raw data editing in KoboToolbox instead of editing via web form.

diff --git a/source/enketo.md b/source/enketo.md deleted file mode 100644 index 2a477a7b4..000000000 --- a/source/enketo.md +++ /dev/null @@ -1,74 +0,0 @@ -# What Are Enketo Web Forms? -**Last updated:** 15 Feb 2022 - -According to [Enketo.org](https://enketo.org), **Enketo** is the name of an -open-source project as well as the name of an open-source web application that -uses a popular open-source form format. - -Enketo was developed as a follow-up to a 2009 Masters Dissertation at the -University of Liverpool on the 'Applicability of -[Offline-capable Web Technologies](https://blog.enketo.org/offline-capable-web-applications/) -for Information Management in Humanitarian Aid'. - -After a year of initial development, it was adopted by -[a lab at Columbia University](https://qsel.columbia.edu/products-tools/) and -[first launched](https://blog.enketo.org/enketo-is-now-open-source-and-will-be-used-in-formhub/) -in 2012. This was the start of a cascade of -[adoption](https://enketo.org/about/adoption/) by companies and organizations -across the world. - -## What Ecosystem does Enketo use? - -Enketo is part of the OpenRosa/ODK ecosystem which means: - -1. Enketo can be combined with other tools to flexibly create a full-fledged - information management system. This has resulted in the adoption of Enketo - into KoboToolbox. It also means that the Enketo Project can focus on just - data collection and do this in the best way possible. -2. Enketo does not require a long-term commitment by the user. - -## What are the general features? - -Surveys deployed with Enketo: - -- work offline -- have beautiful themes and widgets -- are printer-friendly -- can use very powerful skip and validation logic -- run on any device, mobile or desktop, as long as it has a fairly - [modern browser](https://enke.to/modern-browsers) - -## How can I access Enketo when on KoboToolbox? - -Whenever you open a form on the webform version within KoboToolbox, you are -actually using Enketo. For details, please visit our support article -[Collecting Data through Web Forms](data_through_webforms.md). - -## How do I troubleshoot Enketo? - -Enketo web forms work on all devices since they open in regular web browsers and -allow data collection online or offline. Generally we strongly recommend the -latest version of all modern browsers; -[see here for more details on browsers working with Enketo](https://enketo.org/faq/#browsers). - -**Known issues with offline forms on iOS** - -iOS (running on iPhones and iPads) devices have several known limitations with -using offline-enabled forms due to the Apple operating system platform. We -strive to have the latest version of iOS fully supported. - -- Offline data collection works in any modern browser. On iOS we only - recommend Chrome or Safari. -- Version 9.x shows "NotFoundError: DOM IDBDatabase Exception 8". Solution: - Close all Enketo tabs in your browser, then reopen the form. The error - should now be gone forever. -- Version 9.3.1 shows "Attempted to assign to readonly property" when loading - offline form -- Version 8.x shows "undefined is not an object (evaluating 'c.resources')". - Solution: Update to latest iOS version - -If data collection offline is not required and you are seeing an error on iOS, -consider using the _online-only_ version instead of the offline URL. - -For details on troubleshooting, please visit our support article -[Troubleshooting Enketo Web Forms](troubleshooting_webforms.md). diff --git a/source/form_meta.md b/source/form_meta.md index dc71af50e..5544505ec 100644 --- a/source/form_meta.md +++ b/source/form_meta.md @@ -23,10 +23,10 @@ Available metadata questions in the Formbuilder include: | start time | Records the exact time and date when a submission is started. | | end time | Records the date and time when a submission is finalized. | | today | Records the date of the submission. | -| audit | Captures a [detailed log](https://support.kobotoolbox.org/form_meta.html#audit-metadata-question) of the interview process, including start time, end time, location, and user actions during the entire data collection process. This metadata question is not supported in Enketo.| -| username | In KoboCollect, records the username saved in the KoboCollect app settings. If no username is set, it records the one used to sign in to the server.
In Enketo, records the account username only if authentication is required.

Note: Because the username field can be edited in KoboCollect, it may not match the account used to authenticate to the server. To see which account submitted the data, refer to the automatically generated _submitted_by field. | -| phone number | Records the phone number stored in the KoboCollect app settings. This metadata question is not supported in Enketo. | -| device id | Records the unique identification of the device or browser used to collect data. The device ID is automatically generated and cannot be modified by users.

Note: In KoboCollect, the device ID is updated whenever the app is reinstalled on a device. In Enketo, the deviceid resets any time a new browser window is used. | +| audit | Captures a [detailed log](https://support.kobotoolbox.org/form_meta.html#audit-metadata-question) of the interview process, including start time, end time, location, and user actions during the entire data collection process. This metadata question is not supported in web forms.| +| username | In KoboCollect, records the username saved in the KoboCollect app settings. If no username is set, it records the one used to sign in to the server.
When using web forms, the account username is recorded only if authentication is required.

Note: Because the username field can be edited in KoboCollect, it may not match the account used to authenticate to the server. To see which account submitted the data, refer to the automatically generated _submitted_by field. | +| phone number | Records the phone number stored in the KoboCollect app settings. This metadata question is not supported in web forms. | +| device id | Records the unique identification of the device or browser used to collect data. The device ID is automatically generated and cannot be modified by users.

Note: In KoboCollect, the device ID is updated whenever the app is reinstalled on a device. In web forms, the deviceid resets any time a new browser window is used. | | start geopoint early | Captures GPS coordinates when the form is first opened. Can be used to warm up the device GPS so that later GPS questions can reach accurate readings more quickly. | ## Audit metadata question @@ -46,7 +46,7 @@ Audit logs are saved as CSV files and uploaded with each submission. These files For more information about the exported CSV files, see the full ODK audit logging documentation.

-The audit metadata question is not supported in [Enketo web forms](https://support.kobotoolbox.org/enketo.html). +The audit metadata question is not supported in [web forms](https://support.kobotoolbox.org/data_through_webforms.html). ### Audit settings @@ -71,7 +71,7 @@ To enable background audio recording in the Formbuilder: 1. Open the **Layout & Settings** panel. 2. Turn on the **Enable audio recording in the background** toggle under **Background audio.** -3. Once enabled, audio will be recorded in the background in both KoboCollect and Enketo web forms while the form is being filled out. +3. Once enabled, audio will be recorded in the background in both KoboCollect and web forms while the form is being filled out.

For more information, see Recording interviews with background audio recording. diff --git a/source/form_settings_xls.md b/source/form_settings_xls.md index 7feb02357..7520d3fcf 100644 --- a/source/form_settings_xls.md +++ b/source/form_settings_xls.md @@ -29,7 +29,7 @@ Available form settings in XLSForm include: | version | Includes a string that represents the current version of the XLSForm (e.g., v1 or YYYYMMDD). Useful for tracking form versions for collaboration. | | instance_name | Specifies a unique name for each form submission using fields filled in by the user during the survey. Appears in the data table for each submission. Can be used to create custom participant or submission IDs.

For example, concat(${lname}, '-', ${fname}, '-', today()) returns lastname-firstname-date. | | default_language | Sets the default language in translated forms. The language (code) format is used, as defined in the IANA language registry website. | -| style | Specifies an alternative theme for Enketo web forms. | +| style | Specifies an alternative theme for web forms. | | allow_choice_duplicates | Allows an XLSForm to reuse duplicated option names within a choice list (e.g., when using choice filters where choice names are duplicated). | | public_key | Specifies the public key for encryption-enabled forms. | diff --git a/source/form_style_xls.md b/source/form_style_xls.md index d3d0abd72..828f19fad 100644 --- a/source/form_style_xls.md +++ b/source/form_style_xls.md @@ -1,17 +1,17 @@ # Styling your forms using XLSForm **Last updated:** 20 Mar 2026 -With KoboToolbox, you can customize the appearance of your forms and questions to highlight key information and adapt the layout to your data collection needs. This includes applying themes to Enketo web forms, adding headers and lists in note questions, and using color or bold formatting for emphasis. +With KoboToolbox, you can customize the appearance of your forms and questions to highlight key information and adapt the layout to your data collection needs. This includes applying themes to web forms, adding headers and lists in note questions, and using color or bold formatting for emphasis. -This article covers themes for Enketo web forms as well as styling options for notes and questions within a form. +This article covers themes for web forms as well as styling options for notes and questions within a form.

-Note: This article focuses on styling forms in XLSForm. To learn about setting Enketo themes in the KoboToolbox Formbuilder, see Styling Enketo web forms in the Formbuilder. +Note: This article focuses on styling forms in XLSForm. To learn about setting web form themes in the KoboToolbox Formbuilder, see Styling web forms in the Formbuilder.

-## Themes for Enketo web forms +## Themes for web forms -Enketo themes allow you to customize the appearance and layout of [Enketo web forms](https://support.kobotoolbox.org/enketo.html). Themes apply only to Enketo web forms and are not visible in KoboCollect. +Web form themes allow you to customize the appearance and layout of [web forms](https://support.kobotoolbox.org/data_through_webforms.html). Themes apply only to web forms and are not visible in KoboCollect. ### Adding themes in XLSForm @@ -30,7 +30,7 @@ To add a theme in XLSForm: Note: Themes can be combined by entering both themes in the same cell of the style column, separated by a space (e.g., theme-grid pages).

-### Available themes for Enketo web forms +### Available themes for web forms The following themes are available to customize your forms: @@ -43,7 +43,7 @@ The following themes are available to customize your forms: ### Setting up an XLSForm for theme_grid -In Enketo web forms, the `theme_grid` layout allows you to display questions in multiple columns, making your form more compact and visually organized. The set-up of these columns, including how many there are and how wide each one should be, is controlled by assigning `w-values` to each question inside the `appearance` column of your XLSForm. +In web forms, the `theme_grid` layout allows you to display questions in multiple columns, making your form more compact and visually organized. The set-up of these columns, including how many there are and how wide each one should be, is controlled by assigning `w-values` to each question inside the `appearance` column of your XLSForm.

For a comprehensive overview of using theme_grid in XLSForm, see this Grid Theme Tutorial and sample XLSForm. @@ -67,7 +67,7 @@ Rows will always automatically expand to the full width of the page. For example You can use Markdown and HTML in XLSForm to **style text**, **add emphasis** with bold or italics, **create headers** of different sizes, **change fonts and colors**, and **add clickable web links**. Text styling can be applied to questions, notes, and choice labels.

-Note: Some styling features may not be supported in KoboCollect or Enketo. It is recommended to preview your forms in your chosen data collection method to confirm that all styling features are fully supported. +Note: Some styling features may not be supported in KoboCollect or web forms It is recommended to preview your forms in your chosen data collection method to confirm that all styling features are fully supported.

Text styling features in XLSForm include: diff --git a/source/getting_started_xlsform.md b/source/getting_started_xlsform.md index e7db9e606..e162335a2 100644 --- a/source/getting_started_xlsform.md +++ b/source/getting_started_xlsform.md @@ -120,7 +120,7 @@ Common form settings include: | --- | --- | | `form_title` | Title displayed at the top of the form | | `default_language` | Default form language | -| `style` | Themes for Enketo web forms | +| `style` | Themes for web forms | | `version` | Form version ID | For example, to add a form title: diff --git a/source/glossary.md b/source/glossary.md index 9b9383717..155d8ed60 100644 --- a/source/glossary.md +++ b/source/glossary.md @@ -95,7 +95,7 @@ A feature that continuously records audio during an interview while the form is Empty data collection forms that have been downloaded to a device in the KoboCollect app. These forms contain no responses yet and are ready for data collection. Blank forms are also referred to as **form definitions** in the app.

- For more information, see Data collection using KoboCollect. + For more information, see Collecting data using KoboCollect.

**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Saved forms](https://support.kobotoolbox.org/glossary.html#saved-forms-kobocollect) @@ -205,13 +205,13 @@ Projects that have been published and are ready for data collection, allowing us ## Drafts -Forms that have been started but not yet sent to the server. Drafts can be reopened, edited, and finalized later. In KoboCollect, drafts are stored in the **Drafts** section of the app. In Enketo, drafts are stored locally in the web browser. +Forms that have been started but not yet sent to the server. Drafts can be reopened, edited, and finalized later. In KoboCollect, drafts are stored in the **Drafts** section of the app. When using web forms, drafts are stored locally in the web browser.

- For more information, see Data collection using KoboCollect and Data collection using Enketo web forms. + For more information, see Collecting data using KoboCollect and Collecting data using web forms.

-**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Saved forms](https://support.kobotoolbox.org/glossary.html#saved-forms-kobocollect), [Enketo web forms](https://support.kobotoolbox.org/glossary.html#enketo-web-forms) +**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Saved forms](https://support.kobotoolbox.org/glossary.html#saved-forms-kobocollect), [Web forms](https://support.kobotoolbox.org/glossary.html#web-forms) --- @@ -246,23 +246,11 @@ A security feature that protects form submissions by encoding the data so it can --- -## Enketo web forms - -Browser-based forms used to collect data online or offline, offering an alternative to the KoboCollect Android app and compatible with all major devices. - -

- For more information, see Data collection using Enketo web forms. -

- -**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect) - ---- - ## Enumerator A person who collects data by completing a form during an interview or field visit, either on a mobile device or through a web form. -**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Enketo web forms](https://support.kobotoolbox.org/glossary.html#enketo-web-forms) +**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Web forms](https://support.kobotoolbox.org/glossary.html#web-forms) --- @@ -372,13 +360,13 @@ The nonprofit organization that develops and maintains KoboToolbox, supporting g ## KoboCollect -The KoboToolbox Android app used for mobile data collection, allowing enumerators to download forms, complete them offline, and submit data when connected. It is one of two ways that you can collect data with KoboToolbox, alongside Enketo web forms. +The KoboToolbox Android app used for mobile data collection, allowing enumerators to download forms, complete them offline, and submit data when connected. It is one of two ways that you can collect data with KoboToolbox, alongside web forms.

- For more information, see Getting started with KoboCollect. + For more information, see Setting up the KoboCollect app.

-**Related term(s):** [Enketo web forms](https://support.kobotoolbox.org/glossary.html#enketo-web-forms) +**Related term(s):** [Web forms](https://support.kobotoolbox.org/glossary.html#web-forms) --- @@ -444,7 +432,7 @@ The user who has full control over a KoboToolbox project, including managing its In the KoboCollect app, a project refers to a KoboToolbox account that the app is connected to. Each connected account appears as its own project and can contain multiple forms for data collection.

- For more information, see Getting started with KoboCollect. + For more information, see Setting up the KoboCollect app.

**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect) @@ -604,7 +592,7 @@ A feature that allows KoboToolbox to automatically send data to external systems Forms that contain data entered from the KoboCollect app. This includes drafts, finalized forms, and forms that have already been sent to the server.

- For more information, see Data collection using KoboCollect. + For more information, see Collecting data using KoboCollect.

**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect), [Blank forms](https://support.kobotoolbox.org/glossary.html#blank-forms-kobocollect), [Drafts](https://support.kobotoolbox.org/glossary.html#drafts) @@ -665,6 +653,18 @@ Rules that define what counts as an acceptable answer for a question, such as re --- +## Web forms + +Browser-based forms used to collect data online or offline, offering an alternative to the KoboCollect Android app and compatible with all major devices. + +

+ For more information, see Collecting data using web forms. +

+ +**Related term(s):** [KoboCollect](https://support.kobotoolbox.org/glossary.html#kobocollect) + +--- + ## XLSForm A form design standard that uses Excel spreadsheets to define questions, choices, and form logic, providing a structured way to build complex or advanced forms for KoboToolbox. diff --git a/source/gps_questions.md b/source/gps_questions.md index 7ed4f9de8..b7410103f 100644 --- a/source/gps_questions.md +++ b/source/gps_questions.md @@ -3,7 +3,7 @@ GPS questions are used to **collect geographic coordinates and spatial data** during data collection. They allow you to capture precise locations, map routes, or define areas directly within your form. These question types are useful for activities such as mapping infrastructure, tracking field visits, monitoring environmental sites, or recording service locations. -This article explains the available GPS question types in the Formbuilder, how to add and configure them, the differences in behavior between Enketo web forms and KoboCollect, and the advanced appearance options available for collecting location data. +This article explains the available GPS question types in the Formbuilder, how to add and configure them, the differences in behavior between web forms and KoboCollect, and the advanced appearance options available for collecting location data. ## GPS question types @@ -35,12 +35,12 @@ The table below displays the default appearances for GPS questions: ![Default appearances of GPS questions](images/gps_questions/table.png) -In **Enketo web forms**, respondents can select a location directly on the map, search for an address, or manually enter GPS coordinates. +In **web forms**, respondents can select a location directly on the map, search for an address, or manually enter GPS coordinates. In **KoboCollect**, the device’s current location is recorded automatically, and manual selection or coordinate entry is not available by default.

-Note: To learn more about GPS data collection behaviors in Enketo and KoboCollect, see Collecting GPS data. +Note: To learn more about GPS data collection behaviors in web forms and KoboCollect, see Collecting GPS data with KoboToolbox.

### Advanced appearances @@ -58,10 +58,10 @@ The following advanced appearances are available for GPS questions: | Appearance | Description | Compatibility | |:---|:---|:---| -| maps | Displays a map for users to visualize the location that is being automatically recorded (Point only). | KoboCollect only (included in default Enketo appearance) | -| placement-map | Allows for manual selection of a location on a map (Point only). | KoboCollect only (included in default Enketo appearance) | -| hide-input | Shows a larger map and hides other input fields (latitude, longitude, altitude, accuracy).
![Hide input advanced appearance](images/gps_questions/hide-input.png) | Enketo only | +| maps | Displays a map for users to visualize the location that is being automatically recorded (Point only). | KoboCollect only (included in default web form appearance) | +| placement-map | Allows for manual selection of a location on a map (Point only). | KoboCollect only (included in default web form appearance) | +| hide-input | Shows a larger map and hides other input fields (latitude, longitude, altitude, accuracy).
![Hide input advanced appearance](images/gps_questions/hide-input.png) | Web forms only |

-Note: If you are using Enketo and want to record GPS location automatically without allowing respondents to manually select or enter coordinates, consider using the background-geopoint metadata question. +Note: If you are using web forms and want to record GPS location automatically without allowing respondents to manually select or enter coordinates, consider using the background-geopoint metadata question.

diff --git a/source/group_repeat.md b/source/group_repeat.md index 870274b15..f72152013 100644 --- a/source/group_repeat.md +++ b/source/group_repeat.md @@ -76,12 +76,12 @@ After creating a question group, you can customize its behavior and appearance. ### Displaying grouped questions on the same screen -In KoboCollect, questions appear one at a time by default. In Enketo web forms, all questions appear on the same screen. +In KoboCollect, questions appear one at a time by default. In web forms, all questions appear on the same screen. To display questions by group on the same screen during data collection, click the **Settings** icon to the right of the group name. Then, under **Appearance (Advanced)**, select **field-list** (Show all questions in this group on the same screen).

- Note: If you plan to collect data using Enketo web forms, you will also need to enable the Multiple pages theme in the Form style menu (Layout & Settings). For more information on Enketo web form styles, see Styling Enketo web forms in the Formbuilder. + Note: If you plan to collect data using web forms, you will also need to enable the Multiple pages theme in the Form style menu (Layout & Settings). For more information on web form styles, see Styling web forms in the Formbuilder.

### Skipping a question group diff --git a/source/grouping_questions_xls.md b/source/grouping_questions_xls.md index acd0ed4dc..2bf69f222 100644 --- a/source/grouping_questions_xls.md +++ b/source/grouping_questions_xls.md @@ -72,7 +72,7 @@ In XLSForm, question groups can be repeated to collect the same set of responses ## Appearance settings for question groups -A common reason to group questions is to display them together on a single page. You can adjust the group's appearance settings to control how grouped questions are shown during data collection. The steps vary depending on whether you are using [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [Enketo](https://support.kobotoolbox.org/enketo.html). +A common reason to group questions is to display them together on a single page. You can adjust the group's appearance settings to control how grouped questions are shown during data collection. The steps vary depending on whether you are using [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [web forms](https://support.kobotoolbox.org/data_through_webforms.html).

Note: Appearance settings to display groups on a single page work both for question groups and repeat groups. @@ -98,14 +98,14 @@ To **display all grouped questions on the same screen** in KoboCollect: | end_group | | | | | survey | -### Using Enketo web forms to collect data +### Using web forms to collect data -By default, Enketo web forms display all questions on a single page. +By default, web forms display all questions on a single page. -To display each group of questions on its own page in Enketo web forms: +To display each group of questions on its own page in web forms: 1. In the `settings` worksheet, add a `style` column. 2. In the second cell of the `style` column, enter `pages`. - * This applies the [pages theme](https://support.kobotoolbox.org/form_style_xls.html) to your Enketo web form, dividing it into separate pages similar to KoboCollect. + * This applies the [pages theme](https://support.kobotoolbox.org/form_style_xls.html) to your web form, dividing it into separate pages similar to KoboCollect. **settings worksheet** diff --git a/source/images/date_time/table.png b/source/images/date_time/table.png index 0741ab3ea..a9d9efabd 100644 Binary files a/source/images/date_time/table.png and b/source/images/date_time/table.png differ diff --git a/source/images/date_time/table1.png b/source/images/date_time/table1.png index b5878a2c9..7bb620afa 100644 Binary files a/source/images/date_time/table1.png and b/source/images/date_time/table1.png differ diff --git a/source/images/gps_questions/table.png b/source/images/gps_questions/table.png index c292b86e2..eab9c93da 100644 Binary files a/source/images/gps_questions/table.png and b/source/images/gps_questions/table.png differ diff --git a/source/images/number_decimal_range/table.png b/source/images/number_decimal_range/table.png index 3dd08ced3..25dd04553 100644 Binary files a/source/images/number_decimal_range/table.png and b/source/images/number_decimal_range/table.png differ diff --git a/source/images/number_decimal_range/table1.png b/source/images/number_decimal_range/table1.png index 49105c574..7ad8eef51 100644 Binary files a/source/images/number_decimal_range/table1.png and b/source/images/number_decimal_range/table1.png differ diff --git a/source/images/number_decimal_range/table2.png b/source/images/number_decimal_range/table2.png index 7a893f982..f2793b340 100644 Binary files a/source/images/number_decimal_range/table2.png and b/source/images/number_decimal_range/table2.png differ diff --git a/source/images/photo_audio_video_file/table_updated.png b/source/images/photo_audio_video_file/table_updated.png index 884e47011..04a7aa0f5 100644 Binary files a/source/images/photo_audio_video_file/table_updated.png and b/source/images/photo_audio_video_file/table_updated.png differ diff --git a/source/images/select_one_and_select_many/table.png b/source/images/select_one_and_select_many/table.png index c7d2a5d01..f7ed54b6a 100644 Binary files a/source/images/select_one_and_select_many/table.png and b/source/images/select_one_and_select_many/table.png differ diff --git a/source/images/text_questions/table.png b/source/images/text_questions/table.png index d9e00faff..aa0e64d39 100644 Binary files a/source/images/text_questions/table.png and b/source/images/text_questions/table.png differ diff --git a/source/index.rst b/source/index.rst index 2e35ed938..56aa0814c 100644 --- a/source/index.rst +++ b/source/index.rst @@ -136,21 +136,16 @@ Search the knowledge base, browse our resources, and visit our forum for more de :name: home-page-toc-collecting-data data-collection-tools - enketo deploy_form_new_project - recording-interviews data_through_webforms - data-offline kobocollect_on_android_latest - kobocollect_settings data_collection_kobocollect - transferring_forms - devices_for_data_collection - troubleshooting_kobocollect - troubleshooting_webforms + kobocollect_settings collect_gps + recording-interviews collecting_data_multiple_languages + .. raw:: html @@ -266,6 +261,7 @@ Search the knowledge base, browse our resources, and visit our forum for more de add_logo stuck_in_pending manual_upload + transferring_forms .. raw:: html diff --git a/source/kobocollect_on_android_latest.md b/source/kobocollect_on_android_latest.md index 35bc40b4e..03dae6327 100644 --- a/source/kobocollect_on_android_latest.md +++ b/source/kobocollect_on_android_latest.md @@ -1,4 +1,4 @@ -# Getting started with KoboCollect +# Setting up the KoboCollect app **Last updated:** 30 Dec 2025 @@ -9,7 +9,7 @@ KoboCollect is a free, open-source KoboToolbox app designed for data collection Before using KoboCollect, you must [set up a KoboToolbox account](https://support.kobotoolbox.org/creating_account.html) on the KoboToolbox website and [deploy data collection forms](https://support.kobotoolbox.org/quick_start.html).

- This article covers how to connect to KoboCollect for data collection. To learn more about configuring KoboCollect settings and collecting data with the app, see Customizing KoboCollect settings and Data collection using KoboCollect. + This article covers how to connect to KoboCollect for data collection. To learn more about configuring KoboCollect settings and collecting data with the app, see Customizing KoboCollect settings and Collecting data using KoboCollect.

## Installing the KoboCollect app diff --git a/source/kobotoolbox_interface.md b/source/kobotoolbox_interface.md index cb906904a..407606b96 100644 --- a/source/kobotoolbox_interface.md +++ b/source/kobotoolbox_interface.md @@ -49,7 +49,7 @@ In the **Form history** section, you can: * Clone previous form versions. In the **Collect data** section, you can: -* Choose a [data collection method](https://support.kobotoolbox.org/data_through_webforms.html). +* Choose a [data collection mode](https://support.kobotoolbox.org/data_through_webforms.html#data-collection-modes). * Click **Copy** to copy the link or **Open** to open the form in your browser. * Allow submissions [without requiring a username and password](https://support.kobotoolbox.org/project_sharing_settings.html#allowing-submissions-without-authentication). diff --git a/source/language_dashboard.md b/source/language_dashboard.md index 2ba915db0..7b797064b 100644 --- a/source/language_dashboard.md +++ b/source/language_dashboard.md @@ -3,7 +3,7 @@ -Adding translations to a form allows users to **choose their preferred language** during data collection without creating separate forms. Any number of translations can be added. Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [Enketo web forms](https://support.kobotoolbox.org/enketo.html) support form translations. +Adding translations to a form allows users to **choose their preferred language** during data collection without creating separate forms. Any number of translations can be added. Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [web forms](https://support.kobotoolbox.org/data_through_webforms.html) support form translations. You can add translations to your form directly in the KoboToolbox interface or by using [XLSForm](https://support.kobotoolbox.org/language_xls.html). KoboToolbox offers an **intuitive interface** that requires no technical expertise, and allows you to easily add multiple translations to your forms. This approach is useful when working with a small number of questions or when you want to make quick adjustments. diff --git a/source/language_xls.md b/source/language_xls.md index 873966b41..2062b0885 100644 --- a/source/language_xls.md +++ b/source/language_xls.md @@ -1,7 +1,7 @@ # Adding translations in XLSForm **Last updated:** 4 Jan 2026 -Adding translations to a form allows users to switch to their preferred language during data collection without creating separate forms. Any number of translations can be added. Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [Enketo web forms](https://support.kobotoolbox.org/enketo.html) support form translations. +Adding translations to a form allows users to switch to their preferred language during data collection without creating separate forms. Any number of translations can be added. Both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [web forms](https://support.kobotoolbox.org/data_through_webforms.html) support form translations. Most elements displayed in the form can be translated, such as **question labels**, **hints**, **choice labels**, **constraint messages**, and **required messages**. Elements used for form structure, like question names, choice names, and list names, cannot be translated and should remain in the language used for form development and data analysis. @@ -11,7 +11,7 @@ Most elements displayed in the form can be translated, such as **question labels For hands-on practice with adding translations in XLSForm, see KoboToolbox Academy's XLSForm Fundamentals Course.

-When your form includes multiple translations, KoboCollect and Enketo will display a language selector in the **top right corner of the form**, allowing respondents to choose their preferred language. +When your form includes multiple translations, KoboCollect and web forms will display a language selector in the **top right corner of the form**, allowing respondents to choose their preferred language.

To learn more about collecting and managing data from translated forms, see Collecting data in multiple languages. diff --git a/source/managing_permissions.md b/source/managing_permissions.md index 73d67ab92..8f1f353df 100644 --- a/source/managing_permissions.md +++ b/source/managing_permissions.md @@ -9,7 +9,7 @@ KoboToolbox allows you to set different access levels for users on each project. This article explains how to grant permissions to other KoboToolbox users to collaborate on your projects. It covers user-level permissions, row-level permissions, and copying permissions from another project.

-To learn more about sharing your project with others for data collection, see Collecting Data through Web Forms. To learn more about project-level settings for sharing your projects, see Sharing projects with project-level settings. +To learn more about sharing your project with others for data collection, see Collecting data using web forms. To learn more about project-level settings for sharing your projects, see Sharing projects with project-level settings.

## Setting user-level permissions diff --git a/source/managing_repeat_groups.md b/source/managing_repeat_groups.md index 2600c8524..ebbaf6c08 100644 --- a/source/managing_repeat_groups.md +++ b/source/managing_repeat_groups.md @@ -15,7 +15,7 @@ You can view repeated data in the data table, which you can find in the **Table* You can also view the complete data for any given submission, including each repetition of repeat groups, by clicking the **Open** button to the left of each submission. -To edit repeat group data, click the **Edit** button. This will open up the form and allow you to [edit the form data](https://support.kobotoolbox.org/editing_deleting_data.html#editing-submissions-in-enketo) before resubmitting. [Bulk editing](https://support.kobotoolbox.org/editing_deleting_data.html#editing-multiple-submissions-in-bulk) repeat group data is not currently supported. +To edit repeat group data, click the **Edit** button. This will open up the form and allow you to [edit the form data](https://support.kobotoolbox.org/editing_deleting_data.html#editing-submissions-via-web-form) before resubmitting. [Bulk editing](https://support.kobotoolbox.org/editing_deleting_data.html#editing-multiple-submissions-in-bulk) repeat group data is not currently supported.

Note: Repeat group data cannot be displayed in the Reports or Map views due to the data structure of repeat groups. diff --git a/source/manual_upload.md b/source/manual_upload.md index 841ab4d15..6470bcbec 100644 --- a/source/manual_upload.md +++ b/source/manual_upload.md @@ -6,7 +6,7 @@ not prevent you from creating duplicate submissions.

In certain situations, you might not be able to use the standard uploading -option after collecting data with **KoboCollect** or **Enketo Web Forms**. This +option after collecting data with **KoboCollect** or **web forms**. This may be as a result of issues with your mobile device being partially broken (e.g. screen is shattered), or due to being in a remote location without internet access. You may want to download your submissions from the data diff --git a/source/mapping_gps.md b/source/mapping_gps.md index 44cb04e84..f909f7944 100644 --- a/source/mapping_gps.md +++ b/source/mapping_gps.md @@ -17,10 +17,10 @@ KoboToolbox allows you to collect three types of GPS data in your forms: | Line | `geotrace` | A path made up of multiple points | | Area | `geoshape` | An area made up of multiple points | -GPS data can be collected using both Enketo web forms and KoboCollect. All GPS responses appear in the data table and are included in data exports. Only single points, referred to as geopoints in the user interface, can be displayed in the KoboToolbox Map view. +GPS data can be collected using both web forms and KoboCollect. All GPS responses appear in the data table and are included in data exports. Only single points, referred to as geopoints in the user interface, can be displayed in the KoboToolbox Map view.

-To learn more about collecting GPS data in your KoboToolbox forms, see Collecting GPS data. +To learn more about collecting GPS data in your KoboToolbox forms, see Collecting GPS data with KoboToolbox.

## Mapping GPS data in KoboToolbox diff --git a/source/matrix_response.md b/source/matrix_response.md index 8576ab379..be2e19382 100644 --- a/source/matrix_response.md +++ b/source/matrix_response.md @@ -6,7 +6,7 @@ The **Question Matrix** question type allows you to create a structured table of This article explains how to add and configure a question matrix in the Formbuilder, how it appears during data collection, and how to apply advanced logic using XLSForm when needed.

-Note: Question matrices are supported only in Enketo web forms with the Grid theme enabled. They are not supported in KoboCollect. +Note: Question matrices are supported only in web forms with the Grid theme enabled. They are not supported in KoboCollect.

## Adding a question matrix in the Formbuilder @@ -54,11 +54,11 @@ To configure each row: ## Collecting data from a question matrix -Question matrices are supported only in Enketo web forms and require the [Grid theme](https://support.kobotoolbox.org/alternative_enketo.html) to be enabled. They are not supported in KoboCollect. +Question matrices are supported only in web forms and require the [Grid theme](https://support.kobotoolbox.org/alternative_enketo.html) to be enabled. They are not supported in KoboCollect. The question matrix is displayed as a table, with each column representing a question and each row representing an item. -![Question matrix Enketo](images/matrix_response/enketo.png) +![Question matrix](images/matrix_response/enketo.png)

Note: When exporting data or viewing submissions in the data table, question matrix variables are converted to standard XLSForm structure. Each cell in the matrix becomes an individual variable, and the final variable names are created by combining the row’s data column prefix and the column’s data column suffix. As a result, the exported variable names may differ slightly from how the matrix appears in the Formbuilder. diff --git a/source/media.md b/source/media.md index e2789c350..ed6d2c9ce 100644 --- a/source/media.md +++ b/source/media.md @@ -6,7 +6,7 @@ KoboToolbox allows you to add media, including **images**, **audio files**, and **videos**, to notes, questions, and choices in your form. Adding media can increase user engagement and make forms more accessible for users with visual impairments or literacy barriers. -Form media works with both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [Enketo web forms](https://support.kobotoolbox.org/enketo.html). The following types of media files are currently supported: +Form media works with both [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) and [web forms](https://support.kobotoolbox.org/data_through_webforms.html). The following types of media files are currently supported: | Media | Files | | :--- | :--- | @@ -161,14 +161,14 @@ If media files are not appearing in your deployed form, check the following:

Changing the size of a media file -To control the size of images displayed in your questions or choices, you must upload media files with the desired dimensions. Note that using very large files can increase loading times in Enketo forms. +To control the size of images displayed in your questions or choices, you must upload media files with the desired dimensions. Note that using very large files can increase loading times in web forms.

Form takes a long time to load -Enketo forms will load slowly if your media files are large. Reduce the size of image, video, or audio files before uploading them to the server to improve loading times. +Web forms will load slowly if your media files are large. Reduce the size of image, video, or audio files before uploading them to the server to improve loading times.

@@ -182,7 +182,7 @@ Media in KoboToolbox forms is center-aligned by default, and custom alignment (l
Animated GIF files not supported -Animated GIF files are not currently supported by either Enketo web forms or the KoboCollect Android app. +Animated GIF files are not currently supported by either web forms or the KoboCollect Android app.

diff --git a/source/metadata_xls.md b/source/metadata_xls.md index 7737e85e4..429796016 100644 --- a/source/metadata_xls.md +++ b/source/metadata_xls.md @@ -34,14 +34,14 @@ Available metadata questions in XLSForm include: | `start` | Records the exact time and date when a submission is started. | | `end` | Records the date and time when a submission is finalized. | | `today` | Records the date of the submission. | -| `deviceid` | Records the unique identification of the device or browser used to collect data. The deviceid is automatically generated and cannot be modified by users.

**Note:** In KoboCollect, the deviceid is updated whenever the app is reinstalled on a device. In Enketo, the deviceid resets any time a new browser window is used. | -| `username` | In KoboCollect, records the username saved in the KoboCollect app settings. If no username is set, it records the one used to sign in to the server.
In Enketo, records the account username only if authentication is required.

**Note:** Because the `username` field can be edited in KoboCollect, it may not match the account used to authenticate to the server. To see which account submitted the data, refer to the automatically generated `_submitted_by` field.| -| `phonenumber` | Records the phone number stored in the KoboCollect app settings. This metadata question is not supported in Enketo. | -| `email` | Records the email address from the KoboCollect app settings. This metadata question is not supported in Enketo. | +| `deviceid` | Records the unique identification of the device or browser used to collect data. The deviceid is automatically generated and cannot be modified by users.

**Note:** In KoboCollect, the deviceid is updated whenever the app is reinstalled on a device. When using web forms, the deviceid resets any time a new browser window is used. | +| `username` | In KoboCollect, records the username saved in the KoboCollect app settings. If no username is set, it records the one used to sign in to the server.
When using web forms, the account username is recorded only if authentication is required.

**Note:** Because the `username` field can be edited in KoboCollect, it may not match the account used to authenticate to the server. To see which account submitted the data, refer to the automatically generated `_submitted_by` field.| +| `phonenumber` | Records the phone number stored in the KoboCollect app settings. This metadata question is not supported in web forms. | +| `email` | Records the email address from the KoboCollect app settings. This metadata question is not supported in web forms. | | `start-geopoint` | Captures GPS coordinates when the form is first opened. Can be used to warm up the device GPS so that later GPS questions can reach accurate readings more quickly. | | `background-geopoint` | Captures GPS coordinates when a specific question is answered. The question must be specified in the trigger column of the background-geopoint question. | | `background-audio` | Records audio in the background while a form is open. To learn more about this feature, see Recording interviews with background audio recording. | -| `audit` | Captures a detailed log of the interview process, including start time, end time, location, and user actions during the entire data collection process. This metadata question is not supported in Enketo.

To learn more about using the audit question for audit logs and configuring settings, see Form Audit Log (ODK). | +| `audit` | Captures a detailed log of the interview process, including start time, end time, location, and user actions during the entire data collection process. This metadata question is not supported in web forms.

To learn more about using the audit question for audit logs and configuring settings, see Form Audit Log (ODK). | ## Configuring metadata in KoboCollect diff --git a/source/note_questions.md b/source/note_questions.md index 745f2a184..4733bb2aa 100644 --- a/source/note_questions.md +++ b/source/note_questions.md @@ -22,9 +22,9 @@ To add a note question to your form: By default, note questions appear as simple text in your form. -| Enketo web form | KoboCollect | +| Web forms | KoboCollect | |:----------------|:------------| -| ![Note question in Enketo](images/note_questions/enketo_note.png) | ![Note question in KoboCollect](images/note_questions/kobocollect_note.png) | +| ![Note question in web forms](images/note_questions/enketo_note.png) | ![Note question in KoboCollect](images/note_questions/kobocollect_note.png) | ### Advanced appearances diff --git a/source/number_decimal_range.md b/source/number_decimal_range.md index 82ccea194..df97a9205 100644 --- a/source/number_decimal_range.md +++ b/source/number_decimal_range.md @@ -75,9 +75,9 @@ In KoboCollect: If a value exceeds these limits, it cannot be entered. This restriction applies at the time of data entry and prevents saving longer numbers. -### Numeric limits in Enketo web forms +### Numeric limits in web forms -Enketo web forms allow respondents to enter longer numbers, but there are limits to how they are stored: +KoboToolbox web forms allow respondents to enter longer numbers, but there are limits to how they are stored: - Up to **17 digits** are recorded completely. - From **18 to 21 digits**, additional digits are replaced with zeros, and any decimal portion is removed. diff --git a/source/photo_audio_video_file.md b/source/photo_audio_video_file.md index 8e5484e38..9bbea6532 100644 --- a/source/photo_audio_video_file.md +++ b/source/photo_audio_video_file.md @@ -3,7 +3,7 @@ Many data collection projects require more than just quantitative data. KoboToolbox allows you to capture various media files from respondents, including photos, audio recordings, videos, and files, to provide key qualitative information and add visual and auditory depth to your datasets. -The method of capturing or uploading media depends on whether you are using [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [Enketo web forms](https://support.kobotoolbox.org/enketo.html) for data collection. In KoboCollect, you can either upload or record media files directly within the app. With Enketo, you can upload any media file, and record audio directly within the forms. +The method of capturing or uploading media depends on whether you are using [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) or [web forms](https://support.kobotoolbox.org/data_through_webforms.html) for data collection. In KoboCollect, you can either upload or record media files directly within the app. When using web forms, you can upload any media file, and record audio directly within the forms. This article covers the following topics: - Available media question types in KoboToolbox @@ -41,16 +41,16 @@ To add a media question to your form: ## Appearances of media questions -Media questions can display differently depending on whether you are using Enketo web forms or KoboCollect. You can also change the default appearance of media questions. This section details how each question type appears across both platforms, including default and advanced appearance options. +Media questions can display differently depending on whether you are using web forms or KoboCollect. You can also change the default appearance of media questions. This section details how each question type appears across both platforms, including default and advanced appearance options. ### Default appearances -The table below shows how media questions are displayed by default in Enketo web forms and KoboCollect. +The table below shows how media questions are displayed by default in web forms and KoboCollect. ![Default appearances of media questions](images/photo_audio_video_file/table_updated.png)

-Note: Barcode / QR Code questions are supported only in KoboCollect on mobile devices. When a code is scanned using the device’s camera, the value encoded in the barcode or QR code is automatically captured. In Enketo web forms, this question type appears as a standard text field, where respondents must manually enter the value. +Note: Barcode / QR Code questions are supported only in KoboCollect on mobile devices. When a code is scanned using the device’s camera, the value encoded in the barcode or QR code is automatically captured. In web forms, this question type appears as a standard text field, where respondents must manually enter the value.

### Advanced appearances @@ -124,15 +124,15 @@ By default, the **File** question type accepts all file types. To restrict the t
- Audio recording in Enketo prevents access to other questions - When a user records an audio question in Enketo, other questions are locked until the recording is complete. This ensures that the audio is fully captured before the user proceeds with the rest of the form. + Audio recording in web form prevents access to other questions + When a user records an audio question in a web form, other questions are locked until the recording is complete. This ensures that the audio is fully captured before the user proceeds with the rest of the form.

Collecting EXIF data from uploaded images - When images are uploaded through Enketo or KoboToolbox, EXIF data is not preserved by default. To retain EXIF data, use a File question type and set the Accepted Files parameter (body::accept in XLSForm) to .jpg, .jpeg, .png. + When images are uploaded through web forms or KoboToolbox, EXIF data is not preserved by default. To retain EXIF data, use a File question type and set the Accepted Files parameter (body::accept in XLSForm) to .jpg, .jpeg, .png.
diff --git a/source/pull_data_kobotoolbox.md b/source/pull_data_kobotoolbox.md index df67aea3f..3d89155e9 100644 --- a/source/pull_data_kobotoolbox.md +++ b/source/pull_data_kobotoolbox.md @@ -11,7 +11,7 @@ For example, you can use `pulldata()` to: Note: The pulldata() function uses external CSV files as its data source. If you want to reference data from another KoboToolbox project instead of a CSV file, you can use dynamic data attachments.

-Using `pulldata()` helps reduce errors, saves time during data collection, and ensures that forms remain consistent with external reference datasets. This function is supported in both the KoboCollect Android app and Enketo web forms. We recommend using XLSForm to set up the `pulldata()` function. +Using `pulldata()` helps reduce errors, saves time during data collection, and ensures that forms remain consistent with external reference datasets. This function is supported in both the KoboCollect Android app and web forms. We recommend using XLSForm to set up the `pulldata()` function. This article covers the following steps for pulling data from an external CSV: - Setting up your external CSV diff --git a/source/question_options_xls.md b/source/question_options_xls.md index fc807bc31..522ea1065 100644 --- a/source/question_options_xls.md +++ b/source/question_options_xls.md @@ -40,7 +40,7 @@ To add a **guidance hint** in XLSForm: ### Displaying guidance hints in KoboCollect -In Enketo web forms, guidance hints appear in a collapsible **More Details** section. In KoboCollect, they are hidden by default, but you can [change your project settings](https://support.kobotoolbox.org/kobocollect_settings.html#form-management-settings) to always display them or show them in a collapsible section. +In web forms, guidance hints appear in a collapsible **More Details** section. In KoboCollect, they are hidden by default, but you can [change your project settings](https://support.kobotoolbox.org/kobocollect_settings.html#form-management-settings) to always display them or show them in a collapsible section. To display guidance hints in KoboCollect, follow the steps below: 1. Tap the **Project icon** in the top right corner of your screen. diff --git a/source/recording-interviews.md b/source/recording-interviews.md index f72fe3ba2..e05ce9d35 100644 --- a/source/recording-interviews.md +++ b/source/recording-interviews.md @@ -63,9 +63,9 @@ The default **Voice only** setting is suitable for quiet interview settings. For ## Data collection with background audio recordings -Background audio can be recorded using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) as well as in [Enketo web forms](https://support.kobotoolbox.org/enketo.html). +Background audio can be recorded using the [KoboCollect Android app](https://support.kobotoolbox.org/kobocollect_on_android_latest.html) as well as in [web forms](https://support.kobotoolbox.org/data_through_webforms.html). -In Enketo, a disclaimer will appear at the beginning of the form informing respondents that background audio is being recorded. In both Enketo and KoboCollect, a microphone icon showing the recording's duration will be visible at the top of the form while background audio is actively recording. +In web forms, a disclaimer will appear at the beginning of the form informing respondents that background audio is being recorded. In both web forms and KoboCollect, a microphone icon showing the recording's duration will be visible at the top of the form while background audio is actively recording.

Note: When background audio recording is active on a form in KoboCollect, Audio question types are deactivated, as it is not possible to record audio using both features simultaneously in KoboCollect. @@ -110,7 +110,7 @@ Background audio recordings are treated very similarly to audio files collected

Forms with background audio recording saved as drafts - If a form with background audio recording is saved as a draft in Enketo, only the initial recording will be retained. The recording will not resume or be replaced when the draft form is reopened.

+ If a form with background audio recording is saved as a draft when using web forms, only the initial recording will be retained. The recording will not resume or be replaced when the draft form is reopened.

If a form with background audio recording is saved as a draft in KoboCollect, recording will resume when the draft form is reopened. Both recordings will be stored together in a single file.
diff --git a/source/select_from_file_xls.md b/source/select_from_file_xls.md index 625f8f879..6ee70b5a5 100644 --- a/source/select_from_file_xls.md +++ b/source/select_from_file_xls.md @@ -84,7 +84,7 @@ To update your list of choices, edit the external file as needed, re-upload it t
Translated choice lists - Select from file questions do not currently support translated choice lists. Your external choice file can include only a single label column. Any additional translated label columns will be ignored in Enketo or will cause an error in KoboCollect. For forms that include translations, use internal choice lists instead, or set up multiple select from file questions using skip logic to pull from different files depending on the form language. + Select from file questions do not currently support translated choice lists. Your external choice file can include only a single label column. Any additional translated label columns will be ignored in web forms or will cause an error in KoboCollect. For forms that include translations, use internal choice lists instead, or set up multiple select from file questions using skip logic to pull from different files depending on the form language.

diff --git a/source/select_from_image.md b/source/select_from_image.md index de7e9a8e2..643c8ad14 100644 --- a/source/select_from_image.md +++ b/source/select_from_image.md @@ -1,7 +1,7 @@ # Selecting options from an image **Last updated:** 27 Mar 2026 -Selecting options from an image allows respondents to tap or click directly on **specific areas of an SVG file** instead of choosing from a text list. This feature works in both Enketo web forms and the KoboCollect Android app. +Selecting options from an image allows respondents to tap or click directly on **specific areas of an SVG file** instead of choosing from a text list. This feature works in both web forms and the KoboCollect Android app. You might use this feature to: @@ -31,7 +31,7 @@ To create your selectable image file: 3. Save the file.

-Note: In Enketo web forms, only SVG <path> elements are supported as selectable areas. Other SVG shapes, such as rectangles or circles, may not work as expected. KoboCollect supports additional SVG primitives. +Note: In web forms, only SVG <path> elements are supported as selectable areas. Other SVG shapes, such as rectangles or circles, may not work as expected. KoboCollect supports additional SVG primitives.

## Setting up your XLSForm diff --git a/source/select_from_map_xls.md b/source/select_from_map_xls.md index 544cba7cd..9f61fbea6 100644 --- a/source/select_from_map_xls.md +++ b/source/select_from_map_xls.md @@ -101,7 +101,7 @@ If you are using a GeoJSON file to provide GPS coordinates, follow the [GeoJSON

-Note: Selecting options from a map is only available in KoboCollect. In Enketo web forms, the option choices will appear as a normal list of options. +Note: Selecting options from a map is only available in KoboCollect. In web forms, the option choices will appear as a normal list of options.

In KoboCollect, adding a **select type question** with a `map` or `quick map` appearance allows users to choose an option directly from a map rather than from a list. When the map opens, it centers on the device’s current location. Buttons on the right let users recenter on their location or show all available map points. diff --git a/source/select_one_and_select_many.md b/source/select_one_and_select_many.md index 388f764da..d63bd65f1 100644 --- a/source/select_one_and_select_many.md +++ b/source/select_one_and_select_many.md @@ -95,19 +95,19 @@ The following advanced appearances are available for **Select One, Select Many, | Appearance | Description | Compatibility | |:---|:---|:---| -| `minimal` | Displays choices in a drop-down menu.
![Minimal appearance](images/select_one_and_select_many/minimal.png) | Enketo and KoboCollect | -| `autocomplete` | Adds a search bar at the top of the option list.
![Autocomplete appearance](images/select_one_and_select_many/autocomplete.png) | Enketo and KoboCollect (combine with `minimal` appearance) | -| `likert` | Displays answer choices as a Likert scale (**Select One** only).
![Likert scale](images/select_one_and_select_many/likert.png) | Enketo and KoboCollect | -| `compact` | Displays choices side-by-side with minimal padding and without visible choice boxes. The number of choices per row may vary based on the length of each option label.
![Compact appearance](images/select_one_and_select_many/compact.png) | Enketo and KoboCollect | +| `minimal` | Displays choices in a drop-down menu.
![Minimal appearance](images/select_one_and_select_many/minimal.png) | Web forms and KoboCollect | +| `autocomplete` | Adds a search bar at the top of the option list.
![Autocomplete appearance](images/select_one_and_select_many/autocomplete.png) | Web forms and KoboCollect (combine with `minimal` appearance) | +| `likert` | Displays answer choices as a Likert scale (**Select One** only).
![Likert scale](images/select_one_and_select_many/likert.png) | Web forms and KoboCollect | +| `compact` | Displays choices side-by-side with minimal padding and without visible choice boxes. The number of choices per row may vary based on the length of each option label.
![Compact appearance](images/select_one_and_select_many/compact.png) | Web forms and KoboCollect | | `quick` | Auto-advances the form to the next question after an answer is selected (**Select One** only). | KoboCollect only | | `quickcompact` | Displays choices side-by-side with minimal padding and without choice boxes, and auto-advances to the next question after an answer is selected (**Select One** only).
![Quick compact appearance](images/select_one_and_select_many/compact.png) | KoboCollect only | -| `horizontal` | Displays choices in evenly sized columns, with the same number of choices in each row.
![Horizontal appearance](images/select_one_and_select_many/horizontal_columns.png) | Enketo only. Use `columns` instead for compatibility with KoboCollect. | -| `columns` (other) | Displays choices in evenly sized columns, with the same number of choices in each row.
![Columns other appearance](images/select_one_and_select_many/horizontal_columns.png) | Enketo and KoboCollect. | -| `horizontal-compact` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label.
![Horizontal compact appearance](images/select_one_and_select_many/horizontal-compact_columns-pack.png) | Enketo only. Use `columns-pack` instead for compatibility with KoboCollect. | -| `columns-pack` (other) | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label.
![Columns pack appearance](images/select_one_and_select_many/horizontal-compact_columns-pack.png) | Enketo and KoboCollect | -| `columns-n` (other) | Displays available choices in the specified number (n) of columns.
![Columns-n appearance](images/select_one_and_select_many/columns_n.png)| Enketo and KoboCollect | -| `label` | Displays choice labels without the choice boxes. | Enketo and KoboCollect | -| `list-nolabel` | Displays the answer choice boxes without the labels. | Enketo and KoboCollect | +| `horizontal` | Displays choices in evenly sized columns, with the same number of choices in each row.
![Horizontal appearance](images/select_one_and_select_many/horizontal_columns.png) | Web forms only. Use `columns` instead for compatibility with KoboCollect. | +| `columns` (other) | Displays choices in evenly sized columns, with the same number of choices in each row.
![Columns other appearance](images/select_one_and_select_many/horizontal_columns.png) | Web forms and KoboCollect. | +| `horizontal-compact` | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label.
![Horizontal compact appearance](images/select_one_and_select_many/horizontal-compact_columns-pack.png) | Web forms only. Use `columns-pack` instead for compatibility with KoboCollect. | +| `columns-pack` (other) | Displays choices in columns with visible choice boxes. The number of columns may vary by row, depending on the length of each option label.
![Columns pack appearance](images/select_one_and_select_many/horizontal-compact_columns-pack.png) | Web forms and KoboCollect | +| `columns-n` (other) | Displays available choices in the specified number (n) of columns.
![Columns-n appearance](images/select_one_and_select_many/columns_n.png)| Web forms and KoboCollect | +| `label` | Displays choice labels without the choice boxes. | Web forms and KoboCollect | +| `list-nolabel` | Displays the answer choice boxes without the labels. | Web forms and KoboCollect | ## Best practices for using select questions diff --git a/source/text_questions.md b/source/text_questions.md index 2a74ef2c8..bfd9b2a61 100644 --- a/source/text_questions.md +++ b/source/text_questions.md @@ -24,10 +24,10 @@ To add a text question to your form: By default, text questions appear as a single-line text box. -- In [Enketo web forms](https://support.kobotoolbox.org/enketo.html), the text box remains the same size regardless of how much text is entered. It does not support line breaks. +- In [web forms](https://support.kobotoolbox.org/data_through_webforms.html), the text box remains the same size regardless of how much text is entered. It does not support line breaks. - In [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html), the text box expands as you type and supports line breaks, allowing respondents to enter paragraphs. -![Enketo vs KoboCollect text question appearance](images/text_questions/table.png) +![Web forms vs KoboCollect text question appearance](images/text_questions/table.png) ### Advanced appearances @@ -44,9 +44,9 @@ The following appearances are available for text questions: | Appearance | Description | Compatibility | |:---|:---|:---| -| `multiline` | Displays a larger text box for longer text responses.
![Multiline appearance](images/text_questions/multiline.png) | Enketo and KoboCollect | +| `multiline` | Displays a larger text box for longer text responses.
![Multiline appearance](images/text_questions/multiline.png) | Web forms and KoboCollect | | `numbers` | Displays a numeric keyboard instead of a text keyboard (e.g., to collect phone numbers).
![Number appearance](images/text_questions/numbers.png) | KoboCollect only | -| `url` (other) | Displays a clickable URL (Enketo) or **Open URL** button (KoboCollect) under the question text and makes the question read-only. Enter the URL in the question's **Default Response** setting.
![URL appearance](images/text_questions/url.png) | Enketo and KoboCollect | +| `url` (other) | Displays a clickable URL (web forms) or **Open URL** button (KoboCollect) under the question text and makes the question read-only. Enter the URL in the question's **Default Response** setting.
![URL appearance](images/text_questions/url.png) | Web forms and KoboCollect | | `masked` (other) | Masks text entered by the respondent (e.g., a password or confidential information).
![Masked appearance](images/text_questions/masked.png) | KoboCollect only |

diff --git a/source/troubleshooting_kobocollect.md b/source/troubleshooting_kobocollect.md deleted file mode 100644 index 99b6e1ec4..000000000 --- a/source/troubleshooting_kobocollect.md +++ /dev/null @@ -1,86 +0,0 @@ -# Troubleshooting KoboCollect Android Application -**Last updated:** 24 Sep 2025 - - -**-- Kindly report any uncovered issue on our -[community forum](https://community.kobotoolbox.org/)--** - -

- To learn more about connecting KoboCollect to your KoboToolbox account, configuring KoboCollect settings, and collecting data with the app, see Getting started with KoboCollect, Customizing KoboCollect settings and Data collection using KoboCollect. -

- - -_Common error messages with troubleshooting guides:_ - -**Error: Message 'Error getting form list' after selecting 'Download form'** - -**Troubleshooting:** The most likely solutions for this problem is either - -1. Check your URL, you most likely have a small typo in the URL you entered into - the settings. Refer to [this article](kobocollect_on_android_latest.md) on setting up - your android phone/tablet for data collection. - -2. Another possible explanation is that your phone wasn't connected to the - Internet when you selected **Download form**, for example when you are - connected to a WiFi network in a public place that requires you to sign in - through your browser. [This article](kobocollect_on_android_latest.md) discusses in - greater detail how to connect your device with your account. - -**Error: Generic Exception: No peer certificate or Form listing failed. Error: -javx.net.ssl.SSLPeerUnverifiedException...** - -This error appears when KoboCollect tries to communicate with the server but -can't establish a secure (SSL/HTTPS) connection. - -**Troubleshooting:** - -1. Highly likely your device is using the wrong date. Check that the date is - correct, then try again. _Please refer to your phone/tablet manual on how to - set the date._ Android devices reset their dates to 2000 or another year if - ever the battery goes to 0%, which is why this error can appear frequently if - your team has a tendency to drain the battery all the way. - -2. You may also see this error message if you are using a WiFi hotspot that - requires you to sign in after connecting. - -**Error: KoboCollect has crashed** - -**Troubleshooting:** - -1. If this **occurs** while you are trying to **upload submissions or download a - new form**, then your device has a significant interruption in its Internet - connection. Although it sounds alarming, it is harmless: Simply repeat the - upload or download process. - -2. If this **occurs** while you are trying to **open a new form** in your phone, - then the following possible reasons could help you resolve: - - - The form you are trying to open has errors either in the calculate, - constraints or skip routines. This is rare since the system would have - already checked for the errors. - - The form your are trying to open is either too large or has numerous - actions (calculations, large list of responses or other complex - procedures) which cannot be handled by the memory capacity of your device. - Kindly refer to [this article](devices_for_data_collection.md) on - recommended devices. - -**Error: Unable to edit this blank form because the corresponding blank form is -not present or was deleted** - -**Troubleshooting:** - -This type of error message occurs when you try to edit your saved form when the -corresponding blank form is not present or was deleted. - -If this occurs, retrieve the corresponding blank form from your KoboToolbox -account by clicking **Download form** on the home screen and then select the -particular form which requires amendments. - -**Error: Unable to install KoboCollect android app in a device. Shows the -following error message (can’t create directory/storage/sdcard0/odk)** - -**Troubleshooting:** - -You see this error message when your device is out of storage space. To overcome -this issue, free your device by uninstalling some unnecessary app and then try -installing KoboCollect. diff --git a/source/troubleshooting_webforms.md b/source/troubleshooting_webforms.md deleted file mode 100644 index 281edf303..000000000 --- a/source/troubleshooting_webforms.md +++ /dev/null @@ -1,39 +0,0 @@ -# Troubleshooting Enketo Web Forms -**Last updated:** 15 Feb 2022 - - -[Enketo web forms](enketo.md) work on all devices since they open in regular web -browsers and allow data collection online or offline. Generally we strongly -recommend the latest version of all -[modern browsers](https://enke.to/modern-browsers). You could also visit -[Enketo's Frequently Asked Questions](https://enketo.org/faq/#browsers) to learn -more about _what browsers are supported and recommended_ by Enketo. - -## Known issues with offline forms on iOS - -iOS (running on iPhones and iPads) devices have several known limitations with -using offline-enabled forms due to the Apple operating system platform. We -strive to have the latest version of iOS fully supported. - -- Offline data collection works in any modern browser. On iOS we only - recommend Chrome or Safari. -- Version 9.x shows "NotFoundError: DOM IDBDatabase Exception 8". Solution: - Close all Enketo tabs in your browser, then reopen the form. The error - should now be gone forever. -- Version 9.3.1 shows "Attempted to assign to readonly property" when loading - offline form -- Version 8.x shows "undefined is not an object (evaluating 'c.resources')". - Solution: Update to latest iOS version - -If data collection offline is not required and you are seeing an error on iOS, -consider using the _online-only version_ instead of the offline URL. - -## Data loss - -When collecting data through Enekto, users should never clear the browser's -cache (either manually or using some app). Clearing your browser's cache (during -data collection) will remove all the information stored in the browser and thus -your information will not reach your KoboToolbox server. This data loss is -irreversible. Hence we strongly advise users to clear the browser's cache if and -only if you have successfully submitted all your data to your KoboToolbox -server. diff --git a/source/unique_serial_numbers.md b/source/unique_serial_numbers.md index 75b56e959..688788f86 100644 --- a/source/unique_serial_numbers.md +++ b/source/unique_serial_numbers.md @@ -8,7 +8,7 @@ create unique serial numbers using the `calculate` question-type. ## Approach 1: Creating Sequential Unique Serial Numbers Based on Date and Time -This method works best with [Enketo web forms](data_through_webforms.md). It +This method works best with [web forms](data_through_webforms.md). It uses a calculation function to create a unique serial number based on the date and time to the first millisecond. Although this method may not meet all your needs, it should give you an illustration of how much you can stretch calculate @@ -30,7 +30,7 @@ concat(substr(today(), 0, 4), substr(today(), 5, 7), substr(today(), 8, 10), sub ![Calculate example](/images/unique_serial_numbers/calculate_example.png) -In the example, when you preview the deployed form in **Enketo**, you should be +In the example, when you preview the deployed form in **web forms**, you should be able to see the serial number within the note question as shown in the image below: @@ -61,7 +61,7 @@ expression in a `calculate` question type. The example is shown as an | note | note_id | Your Unique ID for this form is: ${ID} | | | survey | -When you preview the example in **Enketo** web forms, the serial number will be +When you preview the example in web forms, the serial number will be presented within the note question as shown in the image below: ![Preview unique id](/images/unique_serial_numbers/preview_uniqueid.png) diff --git a/source/user_specified_other.md b/source/user_specified_other.md index e21ee94b0..920d58f58 100644 --- a/source/user_specified_other.md +++ b/source/user_specified_other.md @@ -23,7 +23,7 @@ meantime, here's how to create them in your form manually using skip logic. shows questions on the same screen that are relevant at the moment the screen is first displayed. Just make sure to put it outside of the group when choosing to display multiple questions on the same screen. (When using - Enketo Webforms this isn't a problem as it dynamically shows questions once + web forms this isn't a problem as it dynamically shows questions once they become relevant.) 3. Add a [skip logic](skip_logic.md) to the previous follow-up question so it is diff --git a/source/viewing_validating_data.md b/source/viewing_validating_data.md index 74c61af9e..c064f8d39 100644 --- a/source/viewing_validating_data.md +++ b/source/viewing_validating_data.md @@ -87,7 +87,7 @@ The submission window displays all responses and includes the following options: - View data in [any form language](https://support.kobotoolbox.org/collecting_data_multiple_languages.html). - Display [XML values](https://support.kobotoolbox.org/glossary.html#xml-value) next to each question. -- **View** and **Edit** the submission [in Enketo](https://support.kobotoolbox.org/editing_deleting_data.html). +- **View** and **Edit** the submission as a [web form](https://support.kobotoolbox.org/editing_deleting_data.html). - **Duplicate** the submission. - **Print** the submission. - **Delete** the submission. diff --git a/source/welcome.md b/source/welcome.md index c2cdec79f..9fd4f9163 100644 --- a/source/welcome.md +++ b/source/welcome.md @@ -54,13 +54,13 @@ For more information about the KoboToolbox question library, see -To learn more about using mobile devices for data collection, see Recommended devices for data collection. +To learn more about different options for collecting data with KoboToolbox, see Data collection with KoboToolbox.

diff --git a/source/xlsform_with_kobotoolbox.md b/source/xlsform_with_kobotoolbox.md index 778b4abc9..bd944c3f6 100644 --- a/source/xlsform_with_kobotoolbox.md +++ b/source/xlsform_with_kobotoolbox.md @@ -132,11 +132,11 @@ to ensure your form functions as expected before launching data collection. There are several tools available to test your XLSForm, including the KoboToolbox platform, the [KoboCollect app](https://play.google.com/store/apps/details?id=org.koboc.collect.android), and [ODK's XLSForm Online](https://getodk.org/xlsform/). When previewing and testing your form, use the same platform that you will use for -data collection: [Enketo web forms](https://support.kobotoolbox.org/enketo.html), [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html), or both. +data collection: [web forms](https://support.kobotoolbox.org/data_through_webforms.html), [KoboCollect](https://support.kobotoolbox.org/kobocollect_on_android_latest.html), or both.

To learn more about setting up KoboCollect to preview and test your forms, see -Getting started with KoboCollect. +Setting up the KoboCollect app.

## Troubleshooting