ODK Collect's main menu contains the following options:
- :menuselection:`Fill Blank Form` allows you to fill any blank form already there in your data collection.
- :menuselection:`Edit Saved Form` looks for forms you've saved, lists them and allows you to edit them.
- :menuselection:`Send Finalized Form` lists all the finalized forms and gives you an option to send them.
- :menuselection:`View Sent Form` displays the forms that have been sent even if they were deleted.
- :menuselection:`Get Blank form` lists all available ODK :term:`Collect` :term:`form` :term:`widget` (question types). The details about which are available on :ref:`basic-form-widgets`.
- :menuselection:`Delete Saved Form` lists all the Saved and Blank Forms and allows you to delete them.
General Settings are accessible from the :guilabel:`⋮` menu on the top-right corner.
It allows us to configure the following:
:menuselection:`Server` settings manage the connection to an ODK Aggregate server or Google Drive account for form management.
See :ref:`connecting-to-server` for more details.
:menuselection:`User Interface` settings allow us to customize the way our app looks and behaves. It includes settings for:
- :guilabel:`Language` - Allows us to select the device language from 49 available options.
- :guilabel:`Text font size` - Lets us select the font-size.
- :guilabel:`Navigation` (Swiping or Buttons) - Allows us to select the navigation method(swipes, buttons or both).
- :guilabel:`Splash Screen` - An image to display when the Collect application loads.
:menuselection:`User Interface` settings page also consists of the Mapping Settings.
Mapping
Map settings are included on the :menuselection:`User Interface` settings page.
- :guilabel:`Mapping SDK` sets the app used for :ref:`geopoint`, :ref:`geoshape`, and :ref:`geotrace` :doc:`form-widgets`. Options are Google Maps (default) and OpenStreetMap.
- :guilabel:`Basemap` sets the specific map used when opening the mapping app.
:menuselection:`Form Management` settings handle default behavior when editing, finalizing, and importing forms.
Form submission
- :guilabel:`Auto send` When enabled, forms are sent immediately when finalized if the device can connect to the internet. You can specify whether to send over WiFi, cellular data, or both.
- :guilabel:`Delete after send` When checked, form instances are deleted once they are sent.
Form filling
- :guilabel:`Default to finalized` When enabled, forms are automatically finalized upon reaching the end of the form. You can opt out of finalizing any form when completing it.
- :guilabel:`Constraint processing` used to select when response constraints are validated: After each swipe, or at finalization.
- :guilabel:`High res video` enables or disables high-resolution video recordings if supported by the video application used.
- :guilabel:`Image size` (v1.11.0+) specifies the maximum number of pixels for the long edge of all images added to forms. Images are scaled down immediately after being added. This setting can be overridden at the form question level. There are five size options available:
- :guilabel:`Original size from camera (default)`: images are unchanged when added to a form. Used when images must contain a lot of detail or when the internet connection used to send submissions is fast.
- :guilabel:`Very small (640px)`: used when images don't need to be detailed and the internet connection used to send submissions is slow.
- :guilabel:`Small (1024px)`: sufficiently detailed for most on-screen viewing but too small for printing.
- :guilabel:`Medium (2048px)`: sufficiently detailed for most uses including printing.
- :guilabel:`Large (3072px)`: used when a lot of detail is needed.
Form import
- :guilabel:`Import saved forms as finalized` When enabled, forms added directly to the :file:`instances/` directory are automatically set to :formstate:`Finalized`.
:menuselection:`User and Device Identity -> Form Metadata` sets identity values which are added to the metadata of forms completed on the device.
User-defined
You can edit the following:
- Username
- Phone number
- Email address
Note
- If no username is set in Form metadata settings, server username in :ref:`Server settings <server-settings>` is used by default in the form.
- If username is defined in Form metadata settings as well as in Server settings, username from Form metadata would be visible in form.
- If you want to ensure that form metadata username can't be changed, you can use the :ref:`admin settings <admin-settings>`.
Device-defined
You cannot edit these:
- Device ID
- Subscriber ID
- SIM serial number
Usage data
When enabled, ODK Collect sends usage and error data back to the ODK development team, which helps us improve the application.
Usage data is anonymized.
Note
Admin settings can be password protected. If you set an :guilabel:`Admin Password` in the Admin settings screen, you will need to re-enter that password to access Admin settings in the future.
Admin settings allow you to :ref:`restrict which General Settings are seen by users <user-access-control-settings>`. To access those settings as an Admin (and see all of them), :gesture:`tap` :guilabel:`General Settings` from the Admin settings page.
When you click on the :guilabel:`Import/Export Settings`, you see a QR Code and a few options.
QR Code or the Quick Response Code is a two dimensional barcode. QR codes can be used to configure Collect on many devices. The QR image presented contains all of your current General and Admin settings, including admin and server passwords. When this QR code is scanned from the ODK Collect app on another device, these settings are imported.
You can click on the 
Warning
Since the QR code may contain the admin and server passwords without encryption, you should be careful about how you share it. It is advised to not send it through an external application but through bluetooth, MMS or any other such service that doesn't allow the third party to access the data.
You can go to :menuselection:`⋮ --> Save settings to disk` to save the QR code.
You can import settings from a QR code saved on your device by clicking on :guilabel:`Select Code from SD Card` option.
QR code is a JSON object with a structure as shown below:
{
"general": {
"protocol": "google_sheets",
"constraint_behavior": "on_finalize"
},
"admin": {
"edit_saved": false
}
}The JSON object isn't encrypted but is compressed using zlib before encoding into QRCode. Therefore the creation process can be summarized as follows:
- Write a JSON object containing the changed settings with a structure as shown above.
- Compress it using zlib.
- Encode into QR code.
After you finish generating the QR code, you can transfer it to your device and then import it by clicking on :guilabel:`Select Code from SD Card` option.
Following is the list of keys for all settings and the set of values they can take:
{
"admin" : {
// Stores the admin password
"admin_password": Boolean,
"admin_pw": String,
// User access control to the main menu. The default value is true.
"edit_saved": Boolean,
"send_finalized": Boolean,
"view_sent": Boolean,
"get_blank": Boolean,
"delete_saved": Boolean,
// User access control to form entry
"save_mid": Boolean,
"jump_to": Boolean,
"change_language": Boolean,
"access_settings": Boolean,
"save_as": Boolean,
"mark_as_finalized": Boolean,
// User access control settings for General settings
"change_autosend": Boolean,
"change_navigation": Boolean,
"change_constraint_behavior": Boolean,
"change_font_size": Boolean,
"change_app_language": Boolean,
"instance_form_sync": Boolean,
"default_to_finalized": Boolean,
"delete_after_send": Boolean,
"high_resolution": Boolean,
"image_size": Boolean,
"show_splash_screen": Boolean,
"show_map_sdk": Boolean,
"show_map_basemap": Boolean,
"analytics" : Boolean,
"change_form_metadata": Boolean,
"change_server": Boolean,
// Server
"import_settings": Boolean,
"change_server": Boolean,
"change_protocol_settings": Boolean,
},
"general" : {
// Server settings
"protocol": {"odk_default", "google_sheets", "other"},
// Aggregate specific key
"server_url": String,
// Google sheets specific keys
"selected_google_account": String,
"google_sheets_url": String,
"username": String,
"password": String,
// Other specific keys
"formlist_url": String,
"submission_url": String,
// User interface
"app_language": { "en", "af", "am", "ar", "bn", "ca", "cs", "de", "es", "km",
"et", "fa", "fi", "fr", "ha", "hi", "hu", "in", "it", "ja", "ka", "zu",
"lt", "mg", "mr", "my", "ml", "nb", "nl", "no", "pl", "ps", "pt", "ro",
"ru", "so","sq", "sw", "ta", "ti", "tl", "tr", "uk", "ur", "vi", "zh"
},
"font_size": {13, 17, 21, 25, 29},
"navigation": {"swipe" ,"buttons" ,"swipe_buttons"},
"showSplash": Boolean,
"splashPath": String, // If showSplash is true, then you specify the path of image here.
"map_sdk_behavior": {"google_maps", "osmdroid"},
// if map_sdk_behavior is google_maps, then map_basemap_behavior can take the following values:
"map_basemap_behavior": {"streets", "satellite", "terrain", "hybrid"},
// if map_sdk_behavior is osmdroid, then map_basemap_behavior can take the following values:
"map_basemap_behavior": { "openmap_streets", "openmap_usgs_topo",
"openmap_usgs_sat", "openmap_stamen_terrain",
"openmap_cartodb_positron", "openmap_cartodb_darkmatter"
},
// Form submission
"delete_send": Boolean,
"autosend": Boolean,
"autosend_wifi": Boolean,
"autosend_network": Boolean,
// Form filling
"constraint_behavior": {"on_swipe", "on_finalize"},
"default_to_finalized": Boolean,
"high_resolution": Boolean,
"image_size": {"original", "small", "very_small", "medium", "large"},
// Form import
"instance_sync": Boolean,
// User and Device identity
"form_metadata": String,
"metadata_migrated": Boolean,
"metadata_username": String,
"metadata_phonenumber": String,
"metadata_email": String,
"analytics": Boolean, // Anonymous usage data
},
}Note
The subkeys in the general key can be a part of the admin key too.
Note
QR code only contains settings whose values are not the default values because of the constraints on the amount of data a QR code can hold.
Warning
The QR code used for settings-import contains the admin and server passwords in plain text. To remove them from the code, :gesture:`tap` the warning on the QR code screen.
This section allows the admin to hide menu items and settings from the user. It contains the following options:
- :guilabel:`Main Menu Settings` : Allows admin to hide some of the main-menu options from the users.
- :guilabel:`User Settings` : Allows admin to select the options that'll be visible to the users in the :guilabel:`General settings` menu.
- :guilabel:`Form Entry Settings` : Admin can configure the form entry items visible to the users. For example unchecking the :guilabel:`change language` option will prevent the user from changing the device language.