Manage Global Dropdown Choices in EarthRanger Admin

In EarthRanger, Event Type dropdown menus allow users and administrators to classify activities in protected areas, such as species sightings, unauthorized activity, and environmental observations. EarthRanger administrators can adjust dropdown choices for Event fields to better reflect their site’s needs. 

Here is the detailed process for modifying these choices, including adding, reordering, and verifying dropdown options.

Understanding Events and Event Types

In EarthRanger:

  • Events are user-facing entries in the application where a specific activity / situation is recorded.
  • Event Types are administrative classifications that configure and organize these activities.

Changes to Event Types in the administration interface directly impact the dropdown choices users see when creating or editing Events.
 

Step 1: Locate the Choice Field to Modify

  1. In the EarthRanger Administration website, navigate to Activity > Event Types.
  2. In the Display column, select the Event Type associated with the Event you want to modify (e.g., Human-Wildlife Contact).
  3. Within the schema for this Event Type, find the title of the dropdown menu field you wish to update (e.g., "Species").
  4. Locate the `enumNames` key, which will display the specific Choice Field value, such as:
        "enumNames": {{enum___wildlifesightingrep_species___names}}  
  5. The value between "enum___" and “___names” is the identifier we will use in the next step to update the options for the list of choices. 
    In this example the identifier is  wildlifesightingrep_species

Step 2: Modify or Add Choices in the Dropdown Menu

You can add or update dropdown choices in two ways: by importing a CSV file (recommended for bulk changes) or by creating and editing choices one by one.
 

Option A: Import Choices from a CSV File

Use this option when adding or updating multiple choices at once.

1.- In the EarthRanger Admin panel, navigate to: Choices > Choices
2.- Click Import choices from CSV.
3.- On the import page, click Download CSV Template to download choice_import_template.csv. Open the file and fill in your choices following the column guide below.
4.- Complete the CSV columns as follows:

Column Required Description
model Yes The model name (e.g. activity.event)
field Yes The Choice Field Identifier from Step 1 (e.g. wildlifesigjtingrep_species)
value Yes A unique lowercase, no-spaces identifier for the choice (e.g. vervet_monkey)
display No How the choice appears in the dropdown. Defaults to value if not provided
icon No Icon identifier
ordernum No Sort order. Lower values appear higher in the list 
is_active No Set to true to enable or false to disable a choice. Defaults to true

 

Note: If a choice with the same model, field, and value already exists, it will be updated rather than duplicated. All rows are validated before any data is imported — if any row contains an error, no changes will be saved. Errors are reported by row number.

5.- Upload your completed CSV file and click Import.
6.- Review any validation errors reported and correct your file if needed before re-importing.

Option B: Add or Edit Choices One by One

Use this option when adding or updating a small number of choices individually.
To add a new choice:

  1. In the EarthRanger Admin panel, navigate to: Choices > Choices
  2. Click Add Choice.
  3. Complete the fields as follows:
    1. Id: Accept the autogenerated value.
    2. Model: Enter activity.event
    3. Field: Enter the Choice Field identifier from Step 1 (e.g., wildlifesightingrep_species).
    4. Value: Enter a lowercase, no-spaces identifier for the new option (e.g., vervet_monkey).
    5. Display: Enter how you want the choice to appear in the dropdown.
    6. Ordernum: Specify a display order with a numerical value. Lower values appear higher in the list. If all choices share the same Ordernum, they will be listed alphabetically.
  4. Click Save.

To edit an existing choice

  1. In the EarthRanger Admin panel, go to Choices > Choices
  2. Use the Search box to enter the Choice Field identifier you'd like to edit the choice options for Step 1 (e.g., "wildlifesightingrep_species") and press the Search button. This will filter the list to show all choice values related to this Choice Field identifier
  3. Select the choice you want to edit.
  4. Update the Display text or Ordernum as needed.
  5. Click Save

Important: Do not update the Value of an existing choice. Changing the Value breaks past Events where this option was selected — the field will display as blank. Updating only the Display text is safe and will update how the choice appears in all past and future Events.

 

Disabling Dropdown Choices

Rather than deleting a choice, disable it to make it unavailable for new Events while preserving it in past Events.

To disable choices one by one:

  1. In the EarthRanger Admin panel, navigate to: Choices > Choices
  2. Search for the relevant Choice Field or specific choice.
  3. Select the checkbox for the choice(s) you want to disable.
  4. From the Action dropdown, select Disable selected choices and click Go.

To disable choices via CSV import:

In your CSV file, set is_active to false for any choice you want to disable. When imported, those choices will be deactivated without being deleted.

Disabled choices no longer appear in the dropdown for new Events but remain visible in past Events where they were selected. To view disabled choices, click Inactive Choices at the top of the Choices page.

 

Disabled choices will no longer appear in the dropdown menu for new Events but will remain visible in past Events where they were selected.

You can find disabled choices by clicking on the Inactive Choices button at the top of the Choices page

 


Step 3: Verify the Dropdown Changes in Events

To confirm the changes in EarthRanger:

  1. Refresh the EarthRanger web application
  2. Create a new Event of the type you modified (e.g., Human Wildlife Contact)
  3. Check the dropdown to confirm the new choices display as configured
     

Following these steps allows administrators to customize Event dropdown choices to reflect site-specific classifications and improve usability for EarthRanger users.

 

 

 

 

Up Next: Configure Feature Classes for Map Layer Styling