Attach a homeowner's utility bill to a project and auto-populate their monthly energy usage.
Overview
Utility Bill Upload lets you attach a PDF or photo of a homeowner's electricity bill directly to a project in Aurora. This serves two purposes: it stores the bill on the project for easy reference, and it uses the bill to automatically populate the project's monthly energy usage fields.
When a bill is uploaded, Aurora reads it and populates the energy usage fields based on the billing month shown on the bill. That single month's value is then used to model the homeowner's full month-by-month consumption profile. If multiple months are included in the uploaded bill, then multiple months may be parsed and added to the consumption profile.
Important: Uploading a bill will override any existing monthly energy usage information on the project. Always review the populated values before presenting a proposal.
What Gets Populated
Uploading a bill updates the following on the Energy Usage page:
- Monthly energy usage (kWh) — populated for the billing month on the bill
- Monthly electricity cost ($) — populated for the billing month on the bill
Aurora uses that single month's data to estimate the homeowner's full annual consumption profile across all 12 months.
What does not get auto-populated: The Pre-solar rate, utility provider, customer name, and address fields are not automatically set from the bill. You will need to set the utility rate manually. Aurora does read these values from the bill as part of processing, but they are not currently written back to the project's rate or customer profile fields.
Availability
| Bill upload (UI + API) | All accounts, all regions |
| Energy usage auto-population | US markets only. In EU markets, bills can be uploaded and stored, but automatic energy usage population is not yet available. |
Uploading a Utility Bill
From the Energy Usage Page
- Open the project and click Energy usage in the left navigation.
- Click the Upload a utility bill area, or drag and drop a file onto it.
- Select a PDF or image (JPG, PNG) of the homeowner's electricity bill.
- Wait for Aurora to process the file. Processing happens in the background — the monthly energy usage fields will update once complete.
- Review the populated kWh and cost values and adjust manually if needed.
Via the Enterprise API
You can also upload utility bills programmatically. See the Run Utility Bill Upload API reference for details..
Reviewing the Result
After a bill is processed, go to the Energy usage page to review the updated values. Aurora populates the monthly fields based on the billing month's data and models the remaining months from that figure. Because bills vary in format and accuracy can differ by utility provider, we recommend reviewing the numbers before using them in a proposal.
If the populated values look incorrect, you can edit any monthly field manually. The utility rate (Pre-solar rate) and post-solar rate fields are not affected by the upload and should be set separately.
Uploading Multiple Bills
You can upload more than one bill to a project. Each new upload overwrites the energy usage data from the previous bill. Only the most recent upload is visible on the project.
Troubleshooting
Energy usage fields didn't update after upload
- Processing happens asynchronously. If you navigated away immediately after uploading, wait a moment and refresh the page.
- Check that the file is a clear, legible PDF or image of an electricity bill. Blurry scans or non-electricity documents (gas bills, account summaries) may not parse correctly.
The populated usage value seems too high or too low
Aurora uses the billing month's usage to model all 12 months. If the uploaded bill covers an unusually high or low usage month (e.g., peak summer or a mild spring), the annual estimate may not reflect typical usage. Manually entering values for additional months will improve accuracy.
The Pre-solar rate was not updated
This is expected. Utility bill upload does not auto-select the utility rate. You will need to set the Pre-solar rate and Post-solar rate manually on the Energy usage page.