Now that you have downloaded your mobile app, it’s time to give it a whirl! This page provides a step-by-step walkthrough of navigating your newly downloaded CommCare mobile app, sharing some tricks along the way.
1. Logging in
You can log into CommCare for Android as a Mobile User or as a Demo User.
a. Logging in as a Mobile User
After clicking on the CommCare icon, you will reach the login screen. Enter your (mobile user's) username and password (see the attached GIF). For more information on creating and managing users, click here.
Note the following:
The first time you log in, you must have internet connectivity. CommCare will update your phone's information with the server.
After the initial login, you do not need internet connectivity to log in again with the same username.
The username of the last user to log in will remain in the “username” box, even after logging out.
b. Logging in as a Demo User
To enter demo mode, click on the three dots and select "Enter Practice Mode" as shown in the attached GIF. A warning message will appear (forms submitted in Practice Mode will be ignored by CommCare HQ). You'll log in as ‘demo_user’ and see the option to ‘Submit Practice Data to Server’ under Sync option. To exit Practice Mode, log out as ‘demo_user’ and log back in with your normal username and password.
2. Home Screen Overview
Once logged in, you will see the main screen (“home screen”) of CommCare. It is the first screen you see when you log in as a user with user credentials. (image attached below of a home screen)
This screen serves as the main navigation hub and typically includes some elements of Home Screen and Home Screen Settings.
a. Elements of Home Screen
Start: This is where users access forms and submit data.
Sync with Server: This button synchronizes the phone with the server data. The text below indicates pending forms, if there are a lot of pending forms, the text will turn red to alert the user. If you have forms you want to send right away, press "Sync with Server." But remember, you'll need to press ‘Sync’ again after sending the forms to update the ‘sync status’ and ‘last sync time’.
Log Out of CommCare: Logs the user out for data security.
You can translate many parts of the home screen into most languages. See our page on user-interface translations to learn more.
b. Home Screen Settings
To access the home page settings menu, just tap the menu button on your phone (the three dots in the top right corner). You'll see a list of options, as shown in the attached GIF.
Update App: tells the device to check CommCare HQ to see if there is a more recent starred build. If there is, CommCare will update (connectivity required) and you will need to log-in again.
Saved Forms: within the "saved" forms button you can find a list of all forms that were submitted since the last time the application data was cleared. You can further filter this list by submitted forms, unsent forms, or incomplete forms. After you "Save a Form as Complete" it is tagged as "Unsent" until CommCare confirms that the form has reached the CommCare HQ server, at which time the tag is removed. More details on all of the form management features can be found here.
Change Language: this allows you to switch to a different language in which you want to use the application.
About CommCare: provides some legal info about CommCare.
Advanced: this allows you to do some advanced actions like force log submission, clear user data, Connection test, etc
Clear User Data: if you choose this, it will delete all the current users’ data and bring you back to the log-in screen.
Force Log Submission: this forces CommCare to submit technical metadata to the server. This can be useful to the software team when troubleshooting problems. A CommCare team member could request you to do this if there is a recurring bug in the software.
Connection test: diagnoses connection problems that the user might be having on the device
Settings: this allows you to access some advanced settings like Auto-update frequency, Fuzzy Search Matches, etc.
3. Selecting a Module/Menu
After clicking the Start icon, you will be taken to the application’s main screen, which lists the available modules. Modules (also called Menu’s) are organized sets of forms and workflows within the application. To learn more about Menu’s see this link : Menus .
Module List: Displays all the modules within the selected application.
Module Names: Tap on the module name to select it. Modules are typically named to reflect the type of data collection or process they support (e.g., "Patient Registration," "Follow-Up Visits").
4. Choosing a Form
Within the selected module, you will see a list of forms. Each form represents a different data collection instrument or task.
Form List: Displays all the forms available within the selected module.
Form Names: Tap on the form name to select it. Forms are named to indicate their purpose (e.g., "New Patient Intake," "Monthly Report").
5. Filling Out the Form
Once you have selected a form, the form interface will open, allowing you to enter data. Here’s a detailed breakdown of the form interface and navigation:
a. Form Interface Elements:
Questions/Fields: Each screen will display one or more questions or fields to fill out. These can include text inputs, date selectors, multiple-choice questions, and more.
Navigation Buttons:
Next/Forward Arrow: Move to the next question or section.
Back Arrow: Return to the previous question or section.
Multimedia Inputs: If required, you may need to capture photos, record audio, or scan barcodes. Follow the on-screen prompts to complete these tasks.
Save Button: Save your progress if the form supports it, allowing you to return later.
Progress Bar: The progress bar on the top of the screen shows how far you have reached in the form.
b. Input Data:
Enter the required information in the respective fields. Pay attention to any field validation messages that may prompt you to correct errors.
To read more about Adnaved Form and Menu Settings, visit this page: Advanced Form and Menu Options
6. Exiting a Form
Exiting or ending a form involves a few steps to ensure that the data you have entered is either saved or submitted properly.
At the end of the form, you have options to save, submit, or exit the form. The exact options may vary depending on the configuration of the form and the workflow requirements.
a. Save Progress:
Partial Save: If you need to save your progress and complete the form later, look for a "Save" or "Save and Exit" button. This option saves your current progress without submitting the form.
Draft Mode: Some forms may allow you to save your work as a draft. Drafts can be accessed and edited later before final submission.
b. Exiting without Saving
If you need to exit the form without saving or submitting, you can do so, but be aware that unsaved data may be lost. When you hit the “back” button on a form you are working on, you will get two options
STAY IN FORM: brings you back to the form you were working on
EXIT WITHOUT SAVING: deletes any changes you made/data you entered and brings you back to the home screen
SAVE AS INCOMPLETE FORM: saves form for you to pick up later.
7. Submitting the Form
Once you have completed all the required fields, review your entries for accuracy and navigate to the last page.
On the last page of the form, there will be a button labeled "FINISH". Clicking this button will save the form and exit, sending the completed form data to the CommCare server. After clicking "FINISH", you will see a confirmation message indicating whether your form was "Successfully Completed". This message ensures that your submission has been received and processed.