This guide provides detailed information about the fields in the import multiple deployments CSV file, their behaviour when importing into the WildObs Image Platform, and links to more information. For more information on how to upload multiple deployments to a project, visit Import multiple deployments to a project (in progress).
TABLE OF CONTENTS
- About deployment fields
- How the Import All CSV file is processed
- Location information
- Camera information
- Time information
- Deployment classification
- Camera setup information
- Personnel information
- Additional information
About deployment fields
Deployment fields populate the deployments.csv file of the Camera Trap Data Package (Camtrap DP).
This information can be entered to the WildObs Image Platform when you Add a deployment to a project or you can Import multiple deployments to a project at once by uploading a pre-filled CSV file.
The tables in each section below provide the following information:
- CSV name – Header name of the column for the multiple import all CSV file.
- Field name - This is the name of the field on the WildObs Image Platform. If the field appears differently depending upon the current view, multiple names may be added. For example, Deployment / Camera identifier lists the Camera / Label field.
- Description of the field, examples and units of measurement, if applicable. Please note that units of measurement required may differ between the CSV, platform and the Camtrap DP standard.
- If the field maps directly to a Camtrap DP field, a link to the Camtrap DP page is provided which contains more information, constraints and examples.
How the Import All CSV file is processed
It is important that the CSV file is completed correctly for successful import:
- The CSV file must use the exact column names as the example CSV.
- Each row of the CSV file is treated as an individual deployment.
- Required fields (denoted by an asterisk) must be complete for each deployment or an error will be given.
- Formats for fields are validated when uploading. Be sure to check the input date format to avoid errors.
- Some information creates an entry on the platform, such as camera, tags and groups. The behaviour of these fields is noted under each section.
Location information
The following details create a location entry within the project that can then be selected when adding future deployments. Locations can be added manually from the Locations view, when creating a deployment or when using the import all feature.
| CSV name | Field name | Description | Format |
locationID * | Location / Name Deployment / Location | Identifier describing the field location. Each location ID should have unique coordinates. In the platform, this is called location name. https://camtrap-dp.tdwg.org/data/#deployments.locationID | string |
latitude * | Location / Latitude | Geographic latitude of the deployment site. Example: 45.12345 https://camtrap-dp.tdwg.org/data/#deployments.latitude | number |
longitude * | Location / Longitude | Geographic longitude of the deployment site. Example: 45.12345 https://camtrap-dp.tdwg.org/data/#deployments.longitude | number |
| Feature | A single descriptive feature from a pre-set list can be added to a location from the Locations view. This field cannot be added from the Deployments view or via the import all function. https://camtrap-dp.tdwg.org/data/#deployments.featureType | ||
| Habitat | A habitat, created under Settings > Habitats, can be added to a location from the Locations view. This field cannot be added from the Deployments view or via the import all function. https://camtrap-dp.tdwg.org/data/#deployments.habitat |
Camera information
A unique set of camera information creates a camera entry within the project that can then be selected for deployments. If identical information is used, only one new camera entry will be added. Only camera identifier appears on the deployment view on the platform – other details are accessible via the Cameras list.
| CSV name | Field name | Description | Format |
cameraID * | Camera / Label Deployment / Camera identifier | Unique camera identifier. Example: CAM_1001 | string |
cameraMake | Camera / Make | Manufacturer and model of the camera formatted as manufacturer-model. Example: Reconyx-PC800 https://camtrap-dp.tdwg.org/data/#deployments.cameraModel | string |
cameraSerialNo | Camera / Serial no. | Serial number of the camera. | string |
| cameraYOP | Camera / Year of purchase | Year of purchase of the camera. | integer |
Time information
These fields all appear under the Deployment view when adding manually.
deploymentStart *Start | Date or date-time when the deployment begins. Examples: 12/02/2025 12/02/2025, 12:06:00 AM When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentStart | DD/MM/YYYY or DD/MM/YYYY, HH:MM:SS [AM or PM] |
deploymentEnd *End | Date or date-time when the deployment ends. Must occur after the deployment start. Examples: 12/02/2025 12/02/2025, 12:06:00 AM When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentEnd | DD/MM/YYYY or DD/MM/YYYY, HH:MM:SS [AM or PM] |
utcOffsetUTC Offset | Time zone offset for the deployment. If not provided, the system will use the user's local time zone. Must start with "UTC". Example: UTC+10 | UTC[+ or -]HH |
timestampIssuesInvalid | Used to indicate known timestamp problems. Reflected as "Invalid" column in deployments. Invalid deployments are excluded from data exports. https://camtrap-dp.tdwg.org/data/#deployments.timestampIssues | TRUE or FALSE |
Deployment classification
Deployment tags and Deployment groups can be added under Settings sub-menus. For more information, see Project settings - Other settings.
deploymentTagsTags | Tags used to describe the deployment. Example: Tag 1, TAG2, Tag*3 When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentTags | string Comma-separated values |
deploymentGroupsGroups | Labels used to group deployments, particularly denoting when and where deployments occurred. Example: Group 1, Group2 When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.deploymentGroups. | string Comma-separated values |
Camera setup information
When entering deployments manually, the Platform requests measurements in different units to what is required in the multiple import CSV file detailed below.
detectionDistanceDetection distance | Maximum distance in meters at which the camera can reliably detect activity. https://camtrap-dp.tdwg.org/data/#deployments.detectionDistance | number |
cameraHeightCamera height | Height of camera installation in meters. https://camtrap-dp.tdwg.org/data/#deployments.cameraHeight | number |
cameraHeadingCamera heading | Camera installation direction. The exact value of this field must match one of: North North-East East South-East South South-West West North-West Example: North-East When exported from the platform, this field will be converted to the correct format for https://camtrap-dp.tdwg.org/data/#deployments.cameraHeading | string |
cameraTiltCamera tilt | Vertical tilt angle of camera installation, where -90 is facing down, 0 is horizontal and 90 is facing up. The value can range from -90 to 90. Example: -20 https://camtrap-dp.tdwg.org/data/#deployments.cameraTilt | number |
baitUseBaits | Indicates whether bait was used. The exact value of this field must match one of: Food No bait Visual Other bait Acoustic Scent Example: No bait The WildObs Image Platform only supports a single value from a set selection. When exported from the platform, this field will be converted to a boolean value of true or false to meet the correct format for https://camtrap-dp.tdwg.org/data/#deployments.baitUse. | string |
Personnel information
If the person in the following fields is a user on the project, use the matching first name and last name for the person. If details entered do not match a user on the project, the Principal Investigator will be added to these fields.
If there is no Principal Investigator set, it will default to the project owner. Entering details here that do not match an existing user will not create a user on the project.
setupByPerson deploy | Person responsible for camera setup. Example: Jane Doe https://camtrap-dp.tdwg.org/data/#deployments.setupBy | string |
pickupByPerson pickup | Person responsible for retreiving the camera. Example: Jane Doe | string |
Additional information
deploymentCommentsNotes | Free-text field for notes about the deployment. https://camtrap-dp.tdwg.org/data/#deployments.deploymentComments | string |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article