Skip to content
Merged
Show file tree
Hide file tree
Changes from 18 commits
Commits
Show all changes
98 commits
Select commit Hold shift + click to select a range
38530af
Intro to XLSForm article
salomegarnier Oct 26, 2025
7bea71f
Create placeholder
salomegarnier Oct 26, 2025
2888542
Add placeholder file in edit_forms_excel directory
salomegarnier Oct 26, 2025
c133713
Add files via upload
salomegarnier Oct 26, 2025
52e9416
Minor edits
salomegarnier Oct 26, 2025
2640dd3
Add files via upload
salomegarnier Oct 26, 2025
6eb350f
Add files via upload
salomegarnier Oct 26, 2025
0e39fac
Minor edits
salomegarnier Oct 27, 2025
dcf6ae1
Delete source/images/edit_forms_excel/placeholder
salomegarnier Oct 27, 2025
7aa7c21
Delete source/images/placeholder
salomegarnier Oct 27, 2025
0548bda
Add video embed
salomegarnier Oct 27, 2025
440c09d
Update index.rst
AmandaJ-W Oct 27, 2025
fded4e0
Update index.rst
AmandaJ-W Oct 27, 2025
41bbb11
Create xlsform_with_kobotoolbox.md
AmandaJ-W Oct 28, 2025
3ba34ba
Create placeholder_file
AmandaJ-W Oct 28, 2025
83e9a4e
Add images via upload
AmandaJ-W Oct 28, 2025
b0ed297
Update xlsform_with_kobotoolbox.md
AmandaJ-W Oct 28, 2025
7f325b0
Correct xlsform_with_kobotoolbox
AmandaJ-W Oct 28, 2025
6a61143
Minor edits
salomegarnier Oct 28, 2025
329ec51
Update xlsform_with_kobotoolbox.md
AmandaJ-W Oct 28, 2025
4d418a1
Update xlsform_with_kobotoolbox.md
AmandaJ-W Oct 28, 2025
a5619a9
Minor edits
salomegarnier Oct 28, 2025
6258659
Create question_types_xls.md
AmandaJ-W Oct 30, 2025
e428b9f
Minor edits
salomegarnier Oct 30, 2025
bbda5a1
Create option_choices_xls.md
AmandaJ-W Oct 31, 2025
40735cb
Update XLSForm option choices documentation
salomegarnier Oct 31, 2025
c973d6b
Create grouping_questions_xls.md
AmandaJ-W Nov 3, 2025
94d34ce
Minor edits
AmandaJ-W Nov 3, 2025
9709108
Minor edits
salomegarnier Nov 3, 2025
e6abf7b
Create repeat_groups_xls.md
AmandaJ-W Nov 6, 2025
7667658
Update index.rst
AmandaJ-W Nov 6, 2025
f5443f9
Create question_options_xls.md
AmandaJ-W Nov 6, 2025
bf00d71
Minor edits
salomegarnier Nov 6, 2025
b747cb0
Create appearances_xls.md
AmandaJ-W Nov 7, 2025
ae656d9
Update language_xls.md
AmandaJ-W Nov 7, 2025
9129ffb
Update media.md
AmandaJ-W Nov 7, 2025
bc0ca9f
Add images via upload
AmandaJ-W Nov 7, 2025
849b353
Update question_types_xls.md
salomegarnier Nov 7, 2025
fa80190
Update question_types_xls.md
salomegarnier Nov 7, 2025
921f4e3
Update appearances_xls.md
salomegarnier Nov 7, 2025
a673bab
Update question_options_xls.md
salomegarnier Nov 7, 2025
e3bdf53
Update media.md
salomegarnier Nov 7, 2025
b31e74e
Update language_xls.md
salomegarnier Nov 7, 2025
2d2146c
Update question_options_xls.md
AmandaJ-W Nov 8, 2025
388b5e0
Create form_logic_xls.md
AmandaJ-W Nov 8, 2025
d216afe
Update form_logic_xls.md
AmandaJ-W Nov 8, 2025
c99e491
Create functions_xls.md
AmandaJ-W Nov 8, 2025
3e3826b
Update functions_xls.md
AmandaJ-W Nov 9, 2025
a0ade43
Create skip_logic_xls.md
AmandaJ-W Nov 9, 2025
6cfa5b0
Create constraints_xls.md
AmandaJ-W Nov 9, 2025
3c13547
Create required_logic_xls.md
AmandaJ-W Nov 10, 2025
c315db3
Create choice_filters_xls.md
AmandaJ-W Nov 10, 2025
7e20403
Create placeholder
AmandaJ-W Nov 10, 2025
d54209b
Add images via upload
AmandaJ-W Nov 10, 2025
6ab5c98
Create calculations_xls.md
AmandaJ-W Nov 10, 2025
eb6cf52
Create form_settings_xls.md
AmandaJ-W Nov 10, 2025
2da6549
Create form_style_xls.md
AmandaJ-W Nov 10, 2025
bb141d4
Create placeholder.md
AmandaJ-W Nov 10, 2025
7dbab77
Add images via upload
AmandaJ-W Nov 10, 2025
6c85fb9
Update form_style_xls.md
AmandaJ-W Nov 10, 2025
5180dc8
Update form_style_xls.md
AmandaJ-W Nov 10, 2025
6896998
Update form_style_xls.md
AmandaJ-W Nov 10, 2025
a0ebf7f
Create metadata_xls.md
AmandaJ-W Nov 11, 2025
9683479
Update pull_data_kobotoolbox.md
AmandaJ-W Nov 11, 2025
52b0b54
Add image via upload
AmandaJ-W Nov 11, 2025
73addde
Create select_from_file_xls.md
AmandaJ-W Nov 11, 2025
9a0df65
Create Placeholder
AmandaJ-W Nov 11, 2025
1288563
Add image via upload
AmandaJ-W Nov 11, 2025
a10d29d
Create Placeholder.md
AmandaJ-W Nov 11, 2025
a4a5722
Add files via upload
AmandaJ-W Nov 11, 2025
9b0353e
Create select_from_map_xls.md
AmandaJ-W Nov 11, 2025
fd34334
Update library_locking.md
AmandaJ-W Nov 11, 2025
64615f4
Add images via upload
AmandaJ-W Nov 11, 2025
c475af3
Update library_locking.md
AmandaJ-W Nov 11, 2025
2406883
Update library_locking.md
AmandaJ-W Nov 11, 2025
241de00
Update library_locking.md
AmandaJ-W Nov 19, 2025
2096592
Update metadata_xls.md
AmandaJ-W Nov 19, 2025
6fb0127
Update library_locking.md
AmandaJ-W Nov 19, 2025
d0dafe7
Update form_style_xls.md
salomegarnier Nov 19, 2025
7a8e920
Update form_style_xls.md
salomegarnier Nov 19, 2025
e0f8d5d
Minor edit
salomegarnier Nov 20, 2025
ee766e0
Minor edits
salomegarnier Nov 20, 2025
3de121a
Delete source/images/select_from_file_xls/Placeholder
AmandaJ-W Nov 20, 2025
85fea98
Delete source/images/choice_filters_xls/placeholder
AmandaJ-W Nov 20, 2025
b26e27e
Delete source/images/form_style_xls/placeholder.md
AmandaJ-W Nov 20, 2025
b58bdb6
Delete source/images/xlsform_with_kobotoolbox/placeholder_file
AmandaJ-W Nov 20, 2025
6f9ae36
Minor edits
salomegarnier Nov 20, 2025
a94a12b
Minor edits
salomegarnier Nov 20, 2025
ffb1f38
Minor edits
salomegarnier Nov 20, 2025
4eea529
Minor edits
salomegarnier Nov 20, 2025
4a4109c
Minor edits
salomegarnier Nov 20, 2025
0833408
Minor edits
salomegarnier Nov 20, 2025
8e5b882
Update skip_logic_xls.md
salomegarnier Nov 20, 2025
f756af7
Minor edits
salomegarnier Nov 20, 2025
e828e8d
Minor edits
salomegarnier Nov 20, 2025
00d028d
Minor edits
salomegarnier Nov 20, 2025
632e5ef
Update index.rst
salomegarnier Nov 25, 2025
dd06b41
Merge branch 'master' into xlsform_support_articles
salomegarnier Nov 25, 2025
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
Binary file not shown.
80 changes: 67 additions & 13 deletions source/edit_forms_excel.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,72 @@
# Editing Forms in Excel using XLSForm
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/511ea4cb3c698a4b45e7c2b4efd1af4e356e811f/source/edit_forms_excel.md" class="reference">15 Feb 2022</a>
# Introduction to XLSForm

KoboToolbox is building its forms using a widely shared standard called
[XLSForm](http://xlsform.org/en/). XLSForm makes it possible to create very
complex electronic forms in Excel (or any other spreadsheet program).
KoboToolbox relies on [XLSForm](http://xlsform.org/en/), a standard for designing electronic forms in Excel or other spreadsheet programs. XLSForm makes it easier to manage complex forms, such as those with long choice lists or multiple translations. While the [KoboToolbox Formbuilder](https://support.kobotoolbox.org/formbuilder.html) offers an intuitive, user-friendly interface, XLSForm is recommended when working with advanced functionalities or complex forms.

All forms created with KoboToolbox can be imported from or exported to XLSForm
files. This means they are fully compatible with other related tools such as
[ODK](https://opendatakit.org) or [Formhub](https://formhub.org).
All forms in KoboToolbox are fully compatible with XLSForm. This means you can easily import and export your forms across KoboToolbox and other data collection platforms. XLSForm provides a standardized format for form development using common spreadsheet software, making it a practical option for collaboration and sharing.

Editing a form in Excel can be an easy way to quickly make several changes to a
form (for example for translating an entire form).
This article covers the following topics:

The XLSForm format is wonderfully documented [here](http://xlsform.org/en/).
- Benefits of using XLSForm for form development
- Overview of using XLSForm with KoboToolbox
- Additional resources for learning XLSForm

![image](/images/edit_forms_excel/sample_xlsform.png)

<p class="note">
This article provides an introduction to XLSForm. To get started with building XLSForms, see <a class="reference" href="https://support.kobotoolbox.org/getting_started_xlsform.html">Getting started with XLSForm</a>.
<br><br>
For hands-on practice with form development using XLSForm, see <a class="reference" href="https://academy.kobotoolbox.org/courses/xlsform-fundamentals">KoboToolbox Academy’s online XLSForm Fundamentals Course</a>.
</p>

## Benefits of using XLSForm

XLSForm provides numerous benefits for building both simple and complex data collection forms.

### Efficient form building and editing

XLSForm leverages familiar spreadsheet features for efficient form creation and modification. You can use Excel formulas and functionalities such as copy-pasting, dragging, Find and Replace, sorting, and filtering to quickly build and manage large forms.

### Choice list management for multiple choice questions

XLSForm makes it easy to create and manage [choice lists](https://support.kobotoolbox.org/option_choices_xls.html). You can copy long lists directly from external sources, reuse the same options across multiple questions, or duplicate them across forms, saving time, ensuring consistency, and reducing manual errors.

### Version control and collaboration

XLSForm simplifies sharing and managing form versions. As forms are Excel or Google Sheets files, teams can collaborate on them in real-time, share them for review, and maintain version records.

### Form customization

XLSForm allows you to fully tailor your forms to different needs. You can add and manage [multiple translations](https://support.kobotoolbox.org/language_xls.html) directly in your XLSForm to support multilingual data collection. You can easily set up complex form structures, such as [question groups](https://support.kobotoolbox.org/grouping_questions_xls.html) or [repeating sections](https://support.kobotoolbox.org/repeat_groups_xls.html). Additionally, you can connect your form to [external data sources](https://support.kobotoolbox.org/pull_data_kobotoolbox.html) and [other KoboToolbox projects](https://support.kobotoolbox.org/dynamic_data_attachment.html).

### Advanced functionalities

XLSForm makes it easier to use advanced form building functionalities, such as [skip logic](https://support.kobotoolbox.org/skip_logic_xls.html), [calculations](https://support.kobotoolbox.org/calculations_xls.html), and [constraints](https://support.kobotoolbox.org/constraints_xls.html). As an open standard, XLSForm also offers access to features that may not yet be supported by the KoboToolbox Formbuilder.

## Using XLSForm with KoboToolbox

XLSForm seamlessly integrates with KoboToolbox for form building, previewing, editing, and deployment for data collection.

Users can begin in the KoboToolbox Formbuilder by creating a new form and adding questions, then [download their form](https://support.kobotoolbox.org/xlsform_with_kobotoolbox.html#downloading-an-xlsform-from-kobotoolbox) as an XLSForm for further customization. This provides a structured foundation, which can be useful for new projects or users with less form building experience.

Forms created in XLSForm can then be uploaded to KoboToolbox for previewing, testing, editing, and deployment. Forms can be reviewed for errors and easily modified in KoboToolbox, such as changing the title or settings.

<p class="note">
For more information, see <a class="reference" href="https://support.kobotoolbox.org/xlsform_with_kobotoolbox.html">Using XLSForm with KoboToolbox</a>.
</p>

## Additional XLSForm resources

Numerous resources are available to help learn XLSForm and troubleshoot issues.

KoboToolbox offers the following resources:

- [KoboToolbox Help Center](https://support.kobotoolbox.org): An extensive documentation library with support articles about KoboToolbox and XLSForm.
- [KoboToolbox XLSForm Fundamentals Course](https://academy.kobotoolbox.org/courses/xlsform-fundamentals): An online course developed by our team of experts, which covers a range of skills including creating an XLSForm from scratch, using form logic and calculations, and testing and deploying forms for data collection with KoboToolbox.
- [KoboToolbox Community Forum](https://community.kobotoolbox.org): A space to connect with our global user community, to get help with custom form building or troubleshooting, and to share KoboToolbox resources.

External resources include:

- [XLSForm documentation](https://xlsform.org/en/): An extensive documentation website dedicated to XLSForm.
- [XLSForm Reference and Template](https://xlsform.org/en/ref-table/): A detailed resource for creating and styling forms, including question types, appearances, and optional columns.
- [ODK documentation](https://docs.getodk.org/form-reference/): Another extensive documentation website dedicated to XLSForm.

When using XLSForm, you can create complex questions and forms, which are
introduced in this site.
Loading
Loading