Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
76 commits
Select commit Hold shift + click to select a range
3545793
Reorganize data collection articles in index.rst
salomegarnier Apr 2, 2026
9144086
Modify language_dashboard.md for translation links
salomegarnier Apr 2, 2026
2a314a5
Update references to web forms in documentation
salomegarnier Apr 2, 2026
43db9dc
Remove Enketo
salomegarnier Apr 2, 2026
9e873cd
Add files via upload
salomegarnier Apr 2, 2026
2c91178
Remove Enketo
salomegarnier Apr 2, 2026
fb55b01
Remove Enketo
salomegarnier Apr 2, 2026
b531da6
Update references to Enketo web forms
salomegarnier Apr 2, 2026
55c064a
Remove Enketo
salomegarnier Apr 2, 2026
dd04041
Add files via upload
salomegarnier Apr 2, 2026
ff5abfb
Add files via upload
salomegarnier Apr 2, 2026
e179a57
Remove Enketo
salomegarnier Apr 2, 2026
ccae2e2
Remove Enketo
salomegarnier Apr 2, 2026
e35b93b
Add files via upload
salomegarnier Apr 2, 2026
b08f481
Add files via upload
salomegarnier Apr 2, 2026
a8af7bd
Remove Enketo
salomegarnier Apr 2, 2026
6c61278
Remove Enketo
salomegarnier Apr 2, 2026
ed6d2fc
Add files via upload
salomegarnier Apr 2, 2026
8d75211
Remove Enketo
salomegarnier Apr 2, 2026
b4080b3
Remove Enketo
salomegarnier Apr 2, 2026
cc0fbab
Remove Enketo
salomegarnier Apr 2, 2026
c766257
Update web forms description in welcome.md
salomegarnier Apr 2, 2026
febac61
Remove Enketo
salomegarnier Apr 2, 2026
ad0282b
Remove Enketo
salomegarnier Apr 2, 2026
922100f
Remove Enketo
salomegarnier Apr 2, 2026
d489fa2
Remove Enketo
salomegarnier Apr 2, 2026
96342b2
Remove Enketo
salomegarnier Apr 2, 2026
e3018c8
Add files via upload
salomegarnier Apr 2, 2026
ef069a1
Update metadata_xls.md
salomegarnier Apr 2, 2026
82a532c
Remove Enketo
salomegarnier Apr 2, 2026
f7405f5
Remove Enketo
salomegarnier Apr 2, 2026
b4e1c32
Remove Enketo
salomegarnier Apr 2, 2026
ccf2187
Remove Enketo
salomegarnier Apr 2, 2026
b59b08c
Remove Enketo
salomegarnier Apr 2, 2026
88dfdd6
Remove Enketo
salomegarnier Apr 2, 2026
20cd941
Remove Enketo
salomegarnier Apr 2, 2026
f7a57c5
Remove Enketo
salomegarnier Apr 2, 2026
3ce5f46
Remove Enketo
salomegarnier Apr 2, 2026
1f5a249
Remove Enketo
salomegarnier Apr 2, 2026
5b727ac
Remove Enketo
salomegarnier Apr 2, 2026
93054d3
Remove Enketo
salomegarnier Apr 2, 2026
76b8af2
Update title from 'Getting started' to 'Setting up'
salomegarnier Apr 2, 2026
cfb712a
Modify link text for KoboCollect setup instructions
salomegarnier Apr 2, 2026
1f1a363
Update links to KoboCollect app setup information
salomegarnier Apr 2, 2026
2099d24
Delete source/enketo.md
salomegarnier Apr 2, 2026
d38afce
Delete source/data-offline.md
salomegarnier Apr 2, 2026
70f62a1
Delete source/devices_for_data_collection.md
salomegarnier Apr 2, 2026
d8afd2b
Delete source/troubleshooting_kobocollect.md
salomegarnier Apr 2, 2026
e4a42e2
Delete source/troubleshooting_webforms.md
salomegarnier Apr 2, 2026
8f71bda
Revise data collection link in welcome.md
salomegarnier Apr 2, 2026
2a92dec
Remove Enketo
salomegarnier Apr 2, 2026
2a8ccf7
Fix web forms link in multilingual data collection guide
salomegarnier Apr 2, 2026
5d81024
Update data collection links in XLSForm guide
salomegarnier Apr 2, 2026
638e1e4
Update links for web forms in pull_data_kobotoolbox.md
salomegarnier Apr 2, 2026
8754ab2
Update web forms link for appearance settings
salomegarnier Apr 2, 2026
26a2d35
Update references from Enketo to web forms
salomegarnier Apr 2, 2026
9662fa7
Fix link for web forms in appearances_xls.md
salomegarnier Apr 2, 2026
6b78aaf
Update language_dashboard.md
salomegarnier Apr 2, 2026
d500ea7
Update language_xls.md
salomegarnier Apr 2, 2026
c1ef05d
Update photo_audio_video_file.md
salomegarnier Apr 2, 2026
545f489
Update form_meta.md
salomegarnier Apr 2, 2026
4387a33
Update media.md
salomegarnier Apr 2, 2026
6f395a5
Update text_questions.md
salomegarnier Apr 2, 2026
f6f5324
Add files via upload
salomegarnier Apr 2, 2026
3990d38
Update alternative_enketo.md
salomegarnier Apr 2, 2026
e4a2f69
Update form_style_xls.md
salomegarnier Apr 2, 2026
65e2bd9
Update matrix_response.md
salomegarnier Apr 2, 2026
70a2a9e
Update kobotoolbox_interface.md
salomegarnier Apr 2, 2026
1d3305c
Update managing_permissions.md
salomegarnier Apr 2, 2026
39569cf
Update dynamic_data_attachment.md
salomegarnier Apr 2, 2026
a1234fb
Update dynamic_data_attachment_formbuilder.md
salomegarnier Apr 2, 2026
aca4b2f
Update glossary.md
salomegarnier Apr 2, 2026
1de027e
Update data_collection_kobocollect.md
salomegarnier Apr 2, 2026
843b8fe
Update kobocollect_on_android_latest.md
salomegarnier Apr 2, 2026
00a9a67
Update gps_questions.md
salomegarnier Apr 2, 2026
6c7c8e7
Update mapping_gps.md
salomegarnier Apr 2, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions source/alternative_enketo.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Styling Enketo web forms in the Formbuilder
# Styling web forms in the Formbuilder
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/f3ac4f05b15482eefe3a5bca9c2c18dc6f42dc3f/source/alternative_enketo.md" class="reference">21 Mar 2026</a>

<iframe src="https://www.youtube.com/embed/wLWiw473YSQ?si=tJbKl-VzjZkDPivR" style="width: 100%; aspect-ratio: 16 / 9; height: auto; border: 0;" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

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 <i class="k-icon-settings"></i> **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.
Expand All @@ -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.

<p class="note">
For a comprehensive overview of using the Grid theme, see this <a href="https://ee.kobotoolbox.org/n41GqUkf">Grid Theme</a> Tutorial and <a href="https://docs.google.com/spreadsheets/d/1qKmxPTA4B0vihU6GsKgi1CJE2Db2FfE7KZpOig4nTEI/edit?gid=0#gid=0">sample XLSForm</a>.
Expand Down
56 changes: 28 additions & 28 deletions source/appearances_xls.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<p class="note">
<b>Note:</b> This article focuses on setting question appearances in <a href="https://support.kobotoolbox.org/getting_started_xlsform.html">XLSForm</a>. To learn about setting appearances in the KoboToolbox Formbuilder, see <a href="https://support.kobotoolbox.org/using-formbuilder.html">Using the Formbuilder</a> documentation.
Expand All @@ -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 <a href="https://support.kobotoolbox.org/select_from_map_xls.html">defining GPS coordinates</a> in the `choices` sheet (`select_one` only). | KoboCollect only |
Expand All @@ -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 |

Expand All @@ -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
Expand All @@ -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 |


Expand All @@ -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 |
Expand All @@ -109,19 +109,19 @@ 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
Image questions allow users to [upload or record images](https://support.kobotoolbox.org/question_types_xls.html#media-question-types) directly into their forms.

| 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 |

Expand Down
2 changes: 1 addition & 1 deletion source/calculations_xls.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ To set a dynamic default response:

<details>
<summary><strong>Division by zero</strong></summary>
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 <code>Infinity</code>, 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 <code>Infinity</code>, 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.
</details>

<br>
Expand Down
8 changes: 4 additions & 4 deletions source/collecting_data_multiple_languages.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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).
Expand All @@ -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.

<p class="note">
<strong>Note:</strong> This overrides both the browser language setting and the form’s default language. This functionality applies only to Enketo web forms, not KoboCollect.
<strong>Note:</strong> This overrides both the browser language setting and the form’s default language. This functionality applies only to web forms, not KoboCollect.
</p>

## Managing data in multiple languages
Expand Down
Loading
Loading