This guide walks you through how to create, configure, run, and view an Events Workflow in Ecoscope. This workflow is used to visualize and analyze events pulled from your connected data source.

Results Dashboard

When an Events Workflow is successfully run, it produces a dashboard with multiple components tailored to the configuration choices you made. The dashboard helps you visualize and explore event data to understand where, when, and how often events occurred.
The dashboard is the full results page generated by your workflow. It’s made up of widgets — individual panels such as maps, charts, or filters — that update based on the data you selected in your configuration.

The Dashboard May Display (depending on configuration):

• Map Widgets
  • Events Map – Plots all events that match your configuration, color-coded by event type.
  • Density Map – Displays a heatmap showing where events are most concentrated.

    

• Chart Widgets
  • Events Bar Chart – Shows the number of events over time, broken down by type if applicable.
  • Events Pie Chart – Breaks down events by type as proportions of the total.

• Dashboard Features
  • Filter results based on grouping criteria you defined during configuration.
  • Toggle between grouping “views” (e.g., month, type) from the dropdown in the View Filter widget.
  • Rearrange dashboard widgets to suit your preferred layout.
  • Download individual widgets (maps & charts) as PNG images via the camera icon on each panel.

Configure New Workflow

To create an Events Workflow, go to Workflow Templates from the top navigation and select Events Workflow.

Data Source

Select the data source that provides your events.
If only one data source is configured, it will be selected automatically and cannot be changed.
Note: If you don’t have a data source configured, you won’t be able to reach this screen.

Workflow Details

This section allows you to name and describe your workflow so that it’s easy to find and identify your workflow. Especially if you’re managing multiple workflows across projects and data sources.

• Workflow Name: This must be unique. If you try to submit a name that has already been used, you’ll receive a validation error.
• Workflow Description: This is optional. The description will be displayed on the dashboard to help you or your team remember the configuration context or analytical purpose of the workflow.

Time Range

This section defines the time window of the data you want to analyze. The selected time range determines how much data will be pulled from your data source and directly impacts what’s displayed on your dashboard. 
You will configure: 

• Since – Start date and time
• Until – End date and time
• Timezone – Required to provide fidelity over precise time selection

Tip: Very large time ranges will pull more data and may increase processing time. Consider breaking long periods into smaller workflows for faster results and clearer dashboards.

Event Types

You can narrow your analysis by selecting specific Event Types from the list (pulled from your data source).

• Leave blank to include all event types.
• Add one or multiple types using the dropdown.
  
  Advanced Option: Include events without geometry – Enable this checkbox to include events missing location data (no point or polygon).

Events Bar Chart 

The bar chart gives you a clear view of how events add up over time. To set it up, select a time interval that groups the events. For example, by month for a big-picture view or by day for more detail. This step is required to finish the workflow, even though you’ll find it in the advanced configuration section.

• Time Interval – Choose how the x-axis divides events (year, month, week, day, hour).
   

Tip: If you’re unsure, start with “Month” for a balanced view of trends, then adjust to finer or broader intervals as needed.

Advanced Configuration Options

The sections that follow — Event Location Filter, Basemaps, and Event Density Map — appear after the basic workflow settings.
These options are more advanced than the core configuration, but they are not all optional.

• Event Location Filter, Basemaps, and Event Density Map are optional. Ecoscope provides sensible defaults that will generate a complete dashboard without adjusting them.
• Events Bar Chart settings is required to complete the workflow, but it appears in this section because it offers more advanced customization than the basic setup.

You should adjust these settings if you want to:

• Filter events to a very specific area (optional)
• Change the look and layering of maps (optional)
• Fine-tune the density map for specialized analysis (optional)

Group Data (Optional)

The Group Data section lets you organize your event data into different views within a single dashboard.
 

• Group by Category: Options include event category, event type, or “reported by” name.
• Group by Time: Options include year, month, year/month, day of year, day of month, day of week, hour, or date.

When you switch between views, dashboard widgets (maps, charts, counts) will update to show only that filtered data.

Each grouping creates an additional view. For example, you could group by Event Type to instantly switch between how wildlife sightings, fires, and poacher camp reports look on the same dashboard — without creating separate workflows.
 

Adding multiple groupings will create many views and may slow processing. There’s no hard limit, but it’s best to keep groupings focused on what you actually need to analyze.

Event Location Filter (Advanced)

Use this filter to exclude events from your analysis based on their geographic location.

• Bounding Box – Exclude any events that fall within a defined set of coordinates.
• Filter Point Coordinates – Exclude events recorded at one or more exact coordinates. 
  
  Note: This filter only removes matching events from the results — it does not include events that match a location and ignore all others.

For example, if you add 0,0 as a coordinate filter, the workflow will exclude any events at 0,0 from your dashboard.
 

Map Base Layers (Advanced)

This section controls the map layers displayed on your Events Map and Density Map.
Note that adding more than one map will result in the first basemap being drawn first, then the other basemaps layered on top with the last basemap being the topmost layer. Use the opacity to adjust how these interact. 

• Default: Terrain base layer with Satellite overlay at 50% opacity.
• Other options: OpenStreetMap, Roadmap, Satellite, LandDx, USGS Hillshade, or Custom Layer.

For each basemap, you can:

• Adjust Layer Order (first is drawn first, last is topmost)
• Adjust Layer Opacity (1 = fully visible, 0 = hidden)

Event Density Map (Advanced)

Use these settings to create a heatmap that highlights where events are most concentrated on the map. This can help you spot hotspots, or areas of unusual activity at a glance.

• Auto Scale (default): Ecoscope chooses the grid resolution automatically.
• Custom: Manually define the grid cell size if you want finer control over how dense or spread out the heatmap looks. Smaller cells give you more detail, while larger cells smooth out the view for broader trends.

When you’ve finished configuring all required fields in the workflow, click Submit to generate your dashboard.

If any inputs are missing or invalid, the form will indicate what needs to be corrected.

Run the Workflow

After submission, you’ll be returned to the My Workflows view. Your new workflow will appear in the list with:

In the table, your workflow will show:

• Status: Ready
• No values yet for Last Run Start or Last Run Duration
• A Run button will be available

Click Run to begin processing. The status will change to Running.

Note: Processing time depends on the time range and the amount of event data. Large queries may take up to 10 minutes. 

If the workflow fails, the status will show Failed. Refer to the Common Errors and Causes in case this happens to you. 

View the Dashboard

Once the workflow finishes (status: Success), click the workflow name to open the dashboard.

Explore your maps, toggle between grouped views, and download PNGs of any map or chart for reports or presentations.