Document the counter question type

getodk · Aug 28, 2024 · db14e1f · db14e1f
1 parent 2b0d733
commit db14e1f
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 0 deletions.
diff --git a/docs/form-question-types.rst b/docs/form-question-types.rst
@@ -324,6 +324,30 @@ a manual input is prompted.
 
   integer,ex_integer_widget,Ex integer widget,ex:change.uw.android.BREATHCOUNT,integer type with ex:change.uw.android.BREATHCOUNT appearance (can use other external apps)
 
+.. _counter-widget:
+
+Counter widget
+"""""""""""""""""
+
+type
+  ``integer``
+appearance
+  ``counter``
+
+The counter widget lets users increase a count by one with each click, making it perfect for tracking occurrences, items, or any sequential tallies. 
+Negative numbers aren't supported, so the count starts at zero and can only go up.
+
+.. image:: /img/form-question-types/counter.*
+  :alt: A counter widget displayed in ODK Collect on an Android phone.
+  :class: device-screen-vertical
+
+.. rubric:: XLSForm
+
+.. csv-table:: survey
+  :header: type, name, label, hint, appearance
+
+  integer,counter,Counter widget,integer type with counter appearance,counter
+
 
 .. _date-and-time-widgets:
 

diff --git a/docs/img/form-question-types/counter.png b/docs/img/form-question-types/counter.png