Adding Custom Location Fields

You may want to add and store additional data about each location. In order to do that, you can add custom location fields to your organization structure.

Step 1

To add a field, go to the Organization Structure page, and click on Edit Location Fields

 Step 2

Click on the green "Add a Field" button to add a custom field: 

Step 3

Enter in the following information for the field:

  • Location Property: the unique ID you can use to reference this property in the app builder. This field should be concise, and cannot have any spaces.

  • Label: this is the text that users will see when adding or editing a location in CommCare HQ

  • Required: tick this box if you want the field to be required for all locations.

  • Choices: if you want users to have to choose from a list of dropdowns, click on "add choice" and add as many answer options as you'd like to appear in the dropdown. If you want users to be able to enter in free text, do not add any choices.

See example below where we are adding a field called Facility Type, with three answer options in a dropdown (pharmacy, hospital, and clinic): 

 Step 4

Press the blue "Save Fields" button at the bottom of the page, and your location field will be saved.