Editing a Project in TerraFlow Data Engine

The Edit Project screen lets you update your project's core settings — its name, geographic center point, data retention period, and map output dimensions. Whether you need to rename a project, reposition its center on the map, or adjust how your exported maps look, this is where you'll make those changes.

Time needed: 1 minute

Before you start:

  • You must have an existing project in TerraFlow Data Engine
  • You need edit permissions for the project you want to modify
  • Know the approximate geographic location for your project's center point (if changing it)

Step 1: Open the Edit Project Screen

From the Projects page, find the project you want to modify in the project list.

  1. Click Edit in the row of actions next to the project name.
  2. The Edit Project screen opens, displaying the project's current settings.

If you don't see the project you're looking for, try typing part of its name in the Filter field at the top of the Projects page.

Step 2: Update the Project Name

The Name field appears at the top of the Edit Project screen. This is the display name used throughout TerraFlow Data Engine and on your mobile devices.

  1. Click inside the Name field.
  2. Edit the project name as needed.

Choose a descriptive name that your team will recognize — for example, include the client name, job site, or work order number.

Step 3: Set the Project Center Point

The Center Point section displays an interactive map with a blue pin marker showing the project's current geographic center. This center point determines the default map view when the project is opened on a mobile device.

  1. Use the + and − buttons on the map to zoom in or out.
  2. Click and drag the map to pan to your desired location.
  3. Click directly on the map to move the blue pin marker to the new center point.

Place the center point as close as possible to where your field crew will be working. This ensures the map opens in the right location when technicians start the app.

Step 4: Set the Data Retention Period

The How many days of data to keep on handheld field controls how many days of collected data are stored on your mobile devices before being automatically removed.

  1. Click inside the How many days of data to keep on handheld field.
  2. Enter the number of days you want data to remain on the device (for example, 10).

A lower number keeps devices running efficiently by limiting stored data. A higher number gives field crews access to more historical data in the field. The default value of 10 days works well for most projects.

Step 5: Configure Map Output Dimensions

The Map output width (px) and Map output height (px) fields control the pixel dimensions of map images generated from your project data. These settings affect exported map outputs used in reports and deliverables.

  1. Click inside the Map output width (px) field and enter your desired width in pixels (for example, 700).
  2. Click inside the Map output height (px) field and enter your desired height in pixels (for example, 800).

Larger values produce larger map images. The default values of 600 × 700 pixels are suitable for most standard reports. If you're creating maps for large-format printing or detailed presentations, consider increasing these values.

Step 6: Save or Cancel Your Changes

Once you've made your changes, you have two options at the bottom of the screen:

  1. Click Submit to save all your changes. You will be returned to the Projects list page.
  2. Click Cancel to discard your changes and return to the Projects list without saving.

After clicking Submit, the Projects list will briefly show a loading spinner while your changes are saved. Once the list reloads, your updates are confirmed.

Troubleshooting

I can't find my project on the Projects page.

  • Use the Filter field at the top of the page to search by project name.
  • Check whether the project was deleted by toggling the Include deleted switch to see archived projects.
  • Make sure the correct organization is selected in the organization selector at the top right of the page.

The map pin isn't moving when I click.

  • Make sure you are clicking on the map area itself, not on the zoom controls.
  • Try zooming in closer to your target area before clicking to place the pin more precisely.

I clicked Submit but I'm not sure my changes saved.

  • Return to the Projects list and click Edit on the same project again. Verify that your updated values are shown in the fields.

I accidentally submitted the wrong values.

  • Simply click Edit on the project again and correct the values. There is no limit on how many times you can edit a project.

Tips for Success

  • Use consistent Map output dimensions across projects if your reports require a standard map size.
  • If multiple people work on the same project, communicate any name changes so the team can easily locate the project on their devices.
  • Keep the data retention period balanced — too short and field crews lose access to recent work; too long and device performance may be affected.

Related Articles

  • Creating a New Project in TerraFlow Data Engine
  • Managing Jobs Within a Project
  • Importing Data into a Project
  • Copying and Deleting Projects
  • Working with KML Files

Need more help? Contact TerraFlow Support at support@terraflow.ca