Subjects in EarthRanger represent real-life entities being tracked, such as an elephant named Horton or a helicopter identified as Focke-Wulf. This guide outlines how to add, view, edit, and manage subjects effectively within the EarthRanger Administration interface.
Managing Subjects
To manage subjects:
- Navigate to Home > Observations > Subjects in the EarthRanger Administration interface.
- From here you can view all subjects in the EarthRanger site.
- Clicking on a subject's name allows you to view more details and make changes to that subject (such as assigning sources, see more about sources here: Manage Subject–Source Assignments for Accurate Tracking)
Viewing and Editing Subject Details
Click on any subject name in the list to open its details page, where you can review and update its settings, including its name, subtype, active status, common name, and group assignments.
Subject Settings Overview
Each subject includes the following settings:
-
ID: A unique, non-editable identifier for the subject
(e.g., 000c5333-7e08-4b69-8332-cb9b4ec2460d). -
Name: A custom name for the subject
(e.g., Horton or Focke-Wulf). - Subject Subtype: Classifies the subject within a broader type, for example, "Cheetah" under "Wildlife," or "Patrol Boat" under "Vehicle." The subtype determines the icon displayed for the subject on the map. See Managing Subject Types and Subtypes in EarthRanger
- Active: Indicates if the subject is visible on the map and in the Subjects tab.
-
Common Name: A general name for the subtype
(e.g., White Rhino). - Groups: Lists any existing Subject Groups that can be assigned to the selected subject.
- Subject Attributes: Includes RGB trail color, sex, external ID and External Name.
- Advanced Attributes: Additional data like creation or update timestamps.
- Source Assignments: Shows the source linked to the subject. For more information about Source Assignment visit Managing Sources.
-
Latest Observations: Displays recent observations (location data) for the subject.
Note: To understand more bout the Subject Settings visit Subject Types
Disabling / Deactivating Subjects
When a user, ER Mobile device or animal tracker is no longer in use, a vehicle is decommissioned, or tracking equipment is no longer in use, deactivate the subject rather than deleting it. Deactivation preserves historical tracking data while removing the subject from active views.
Why deactivate instead of delete?
- Maintains complete historical movement data and observations
- Preserves source assignments and data associations
- Prevents data gaps in reports and analytics
- Reversible if you need to restore the subject
How to deactivate a subject:
- Navigate to Home > Observations > Subjects
- Select the subject you want to deactivate
- Uncheck the "Active" checkbox
- Click Save at the bottom of the page
Deactivated subjects will no longer appear on the map, in layers, or in subject selection dropdowns (e.g. “reported by”), but their historical tracking data remains accessible for reports and analysis.
Using the Action Menu
The Action menu on the Subjects page allows you to:
- Export: Save subject data as a .csv file.
-
Delete (Use with Caution)
- ⚠️ Warning: Deleting a subject is permanent and cannot be undone. This action removes all associated tracking data, observations, and source assignments.
- Only delete subjects in exceptional circumstances where complete removal is necessary. In most cases, deactivating subjects is the preferred approach. To delete a subject, select it from the list and choose the delete option from the Action menu.
- Assign Random Trail Color: Generate a random RGB color for the subject’s trail (see more below).
Exporting a Track Data for a Subject
- Select a subject from the list.
- In the Action menu, choose Export as .csv file.
- Click Go to download the file to your local directory.
Assigning a Random Trail Color
- Select a subject from the list.
- In the Action menu, choose Assign a random color.
- Click Go to apply a random RGB value
- The random RGB color will appear in the Subject Attributes
(e.g., 255, 255, 0).
Adding a New Subject
To add a subject:
- Go to Home > Observations > Subjects, then select Add a Subject.
- Enter the required settings: Name and Subtype.
Note: Subjects must be added to a group to appear on the map. You can assign groups during creation or later on the subject details page.
