2.3 Import Multiple Activities via CSV

Use CSV import to create multiple Progress Activities at once instead of adding them individually.

Upload your activity data from a CSV file, review the imported records in GoBuid, fix any errors, and add the valid activities to your project.

CSV import is useful when setting up a new project, transferring activities from an existing schedule, or creating multiple activities across projects.

In this article

How CSV import works

The CSV import process has five steps:

  1. Download the sample file and use it as your template.
  2. Enter your activity data in the CSV file.
  3. Upload the file to GoBuid.
  4. Review and fix errors in the imported activity table.
  5. Add the valid activities to GoBuid.

Start with the sample file

The sample download contains:

  • ImportActivities.csv — Template for your activity data
  • README.txt — Field instructions and sample values

Using the sample file helps ensure that your columns and values follow the required format.

Import activities from CSV

To import Progress Activities:

  1. Open the Project.
  2. Go to Project → Progress.
  3. Select Import CSV.
  4. Download the sample file.
  5. Enter your activity data in the CSV file.
  6. Upload the completed CSV file.
  7. Review the imported activities in the table.
  8. Fix any highlighted errors.
  9. Select Add Activities when the records are ready.

Tip: Keep a copy of your original CSV file. It can be useful if you need to correct data and import it again.

Field requirements

Use the following fields when preparing your CSV file:

Field Required Description
Project Yes The project where the activity will be added. The project name must match a project you have access to.
Activity Yes Name of the Progress Activity.
Total Qty Yes Target quantity for the activity. Enter numbers only.
Unit Yes Unit used to measure the activity, such as m , m2 , item , or lot .
Starts Yes Activity start date. Use YYYY/MM/DD  format.
Ends Yes Activity end date. Use YYYY/MM/DD  format. The end date must be later than the start date.
Location No Optional GPS coordinates for the activity location, such as 1.281619, 103.860433 .

Important: The Project field is required for every row, even when you start the import from within a specific project. GoBuid uses this field to determine which project each activity belongs to.

Example location format

For Location, enter GPS coordinates in this format:

1.281619, 103.860433

Leave the field blank when no location is required.

Review and fix errors

After uploading the CSV file, GoBuid checks the activity data and highlights rows or cells with errors.

You can:

  • Edit values directly in the table
  • Use the error panel to find invalid rows
  • Hover over highlighted cells to see more information
  • Download the edited CSV to keep a copy of your corrections

Review all required fields before submitting if you want every activity to be imported.

Tip: Fix the errors directly in the import table so you can review the corrected data before adding the activities.

Submit valid activities

When the activity data is valid, select Add Activities.

Depending on the errors remaining in the file, GoBuid may allow you to add only the valid activities.

Warning: If you choose to submit only valid activities, rows with errors will be discarded and will not be imported. You cannot return to the same import review screen to fix those discarded rows later.

Download the edited CSV first if you need to keep a copy of the invalid rows or your corrections.

Common errors

Error Example How to fix it
Missing required field Activity name is required Enter the missing required value.
Invalid quantity Quantity must be a number Enter numbers only in Total Qty.
Invalid date format Invalid start date Use YYYY/MM/DD  format.
Invalid date range End date must be after start date Make sure Ends is later than Starts.
Unknown project Project not found Check that the project name is correct and that you have access to the project.
Invalid location Unrecognized location format Enter GPS coordinates in the required format or leave Location blank.

You can see errors directly in the activity table and the error panel. Hover over a highlighted cell for more information.

Important notes

  • Activities with errors will not be imported unless the errors are fixed.
  • Selecting the valid activities only option discards invalid rows.
  • The Project field is required for every activity.
  • Use the sample file when preparing your CSV.
  • Keep the date format as YYYY/MM/DD .
  • Keep a copy of your CSV file before submitting if you may need to recover or correct invalid rows.

Tip: Convert addresses to coordinates

Use tools like:

LatLong

Google Maps