Skip to main content

​
Overview

The Measurement Upload feature allows you to upload CSV measurement files from supported providers and automatically populate measurement values within a job. Instead of manually entering measurements, Zuper reads the uploaded CSV file and maps the data to predefined measurement tokens using built-in system templates. This helps reduce manual data entry, minimize errors, and accelerate job setup.

​
Access & permissions

  • Measurement upload is available to all users who have access to the Job Details page.
  • No additional permission or configuration is required.

​
Prerequisites

Before uploading measurements, ensure that:
  • You have a valid CSV file from a supported provider (Roofr or RoofSnap).

​
Access Measurement Upload

Measurement upload is available within the Measurements section of a job.
  1. Go to the Job details page and open the Measurements section. Click + New Measurement, then select Upload Measurement.
Uplmea1
  1. When the upload panel opens, you must select a provider before uploading the file. These templates contain predefined mappings between the provider’s measurement tokens and Zuper measurement tokens. After selecting a template, proceed to upload the CSV file
Uplmea2
3.    Upload or drag and drop your CSV file. It will be validated automatically. Then click Next.
Uplmea3
  1. Preview the measurement details before creating the file. Then click Create to add it to the details page.
Uplmea21
After reviewing the values, click Create. Zuper generates measurement records within the Job using the values from the uploaded CSV file. The first measurement card is active by default.
Uplmea16

​
Edit Measurement Values

If you modify a value during the preview step, the system displays an Edited label on the measurement after creation.
Uplmea6

​
Activity Tracking

Every measurement upload automatically generates an activity log entry within the Job.
Uplmea18

​
Disabled Measurement Tokens

In some cases, the customer configuration may turn off certain measurement tokens**.** If the uploaded CSV contains values for those tokens:
  • The tokens will still appear within the Job
  • Their values remain visible
This ensures that measurement data from the uploaded file is not lost.

​
Best Practices

  • Always choose the template that matches the source of the CSV file to ensure accurate data mapping.
  • Verify all measurement values in the preview screen before creating measurements.

​
Frequently Asked Questions (FAQs)

1. Do I need to manually set up system templates or field mappings? No. Zuper automatically manages system templates and field mappings. No setup is required. 2. What happens if some measurement tokens are disabled in the configuration?
If the uploaded CSV contains values for disabled tokens, the tokens will still appear in the Job, and their values will remain visible to prevent the imported data from being lost. 3. How to Upload Measurement Attachments?
  • During creation, upload the PDF report when creating the new measurement.
  • After creation: Open the job → go to Measurements →Attachments → Upload.
Note: Only PDF files are supported. 4. Why is my CSV file upload failing in Zuper?
RoofSnap and Roofr use different CSV formats. If the file doesn’t match Zuper’s expected structure, the system cannot read it. Even if the file is valid, the upload will fail. 5. Why do I see this CSV upload error? This happens when the CSV file doesn’t match the selected provider or required format. Zuper can’t read the data, so it shows:
“No measurement data found in the uploaded CSV.” Fix: Use a CSV file from the correct provider and in the correct format.