Field Notes
Solar Document Management: Permits, Plansets, Photos, Contracts & Closeout Files
Control solar permits, plansets, photos, contracts, and closeout files with clear revisions, approvals, release packets, and project-stage ownership.

The most expensive solar document is not always the one you cannot find. It can be the file everyone can find, but nobody realizes is outdated.
A permit coordinator submits revision 4 while procurement is still looking at revision 3. A crew opens a saved plan set that was approved two weeks ago but later superseded. Inspection photos exist, but nobody can tell which checklist item they prove. Finance has the contract, but not the approved change order that changed the billing basis.
That is why solar document management should be treated as workflow control, not digital storage. Every project-critical file needs a purpose, revision, approval state, owner, and release point. The team should be able to answer one question immediately: which exact document is safe to use for this decision right now?
What does solar document management actually need to control?
A solar project produces several kinds of records before, during, and after installation. Some describe what was sold. Some prove what was approved. Some tell the field what to build. Others prove what was actually installed or what the customer, AHJ, utility, finance team, service team, or warranty process may need later.
Storage answers, “Where is the file?” Document control answers a harder set of questions: What is this file for? Which revision is current? Who approved it? Has it been released for permit, procurement, field, customer, finance, or closeout use? What replaced it if it is no longer current?
For an operations team, those questions matter more than the folder structure itself.
| Question | Weak answer | Controlled answer |
|---|---|---|
| Which file? | The newest PDF in the folder | Named document purpose + current revision |
| Is it approved? | Someone emailed it | Approval state + approver + date |
| Can the field use it? | It looks final | Released for field use |
| What changed? | Compare filenames manually | Revision history + change reason |
| What replaced the old copy? | Search the folder | Superseded-by reference |
| What belongs in this submission? | Ask the coordinator | Packet manifest tied to the submission |
Which documents appear at each stage of a solar project?
The exact file set depends on project type, jurisdiction, utility, financing structure, equipment, contract, and company process. A residential rooftop job and a commercial EPC project will not have identical document requirements.
Still, the project usually creates recognizable document families. Treating them by purpose makes control easier than allowing every department to invent its own folder tree.
| Project stage | Common document families | Operational question |
|---|---|---|
| Sale / contract | Proposal, signed agreement, disclosures, customer approvals, financing records where applicable | What exactly was sold and approved? |
| Survey / design | Site survey, measurements, photos, design files, equipment assumptions, engineering records | What facts and design basis are current? |
| Permitting | Application, plan set, calculations, cut sheets, signatures, correction letters, resubmission package, approval | What did the AHJ review and approve? |
| Interconnection | Utility forms, diagrams, agreements, requested evidence, inspection or meter records, PTO correspondence | What has the utility accepted and what remains open? |
| Procurement / field | Approved equipment list, purchase records, current field set, work instructions, checklists, photos, issue evidence | What should be installed and what was actually installed? |
| Finance / closeout | Change orders, milestone evidence, invoices, inspection records, PTO, as-builts, warranties, manuals, customer handoff records | What proves completion, billing basis, and future service history? |
The Department of Energy notes that permitting and inspection requirements vary across local governments and that administrative errors and backlogs can contribute to delays. That variation is one reason the required packet cannot safely live only in one coordinator’s memory.
The real problem is current versus outdated, not folder versus no folder
A shared drive can be perfectly organized and still allow the wrong file to reach the wrong team. File names such as FINAL.pdf, FINAL-2.pdf, Approved-Final.pdf, and Final-Use-This.pdf are not document control.
The team needs an explicit document state. A practical model is Draft → In Review → Approved for a Purpose → Superseded → Record Copy.
Approved for a purpose is more useful than simply approved
A plan set can be technically reviewed but not yet ready for permit submission. A permit-approved set may still need a controlled field release after an equipment or site change. A customer-facing PDF may be safe to share while internal engineering comments are not.
That is why the approval should state the use: approved for permit submission, approved for procurement, released to field, approved for customer handoff, or accepted as the record copy. The labels are examples, not universal industry terminology. Each company should define the purposes that match its workflows.
Superseded files should remain visible but unusable by default
Deleting every old version removes history. Leaving every old version looking equally valid creates risk. The better pattern is to preserve history while clearly marking which version is no longer in effect and what replaced it.
NREL’s PV O&M best-practices guide recommends access control, change control, backup, and version control, specifically so users can identify the document currently in effect while retaining document history. That principle starts during delivery, not only years later during maintenance.
Build release packages, not just folders
A project stage often needs a set of documents to move together. The useful operating object is therefore not always one file. It is a controlled release package.
A permit submission may contain an application, plan set, structural or electrical information where required, equipment documentation, forms, signatures, and other jurisdiction-specific items. The release package should identify exactly which files and revisions were sent together.
The same idea applies to a field release or closeout package. Instead of asking what was probably in the folder on a particular day, the team can reproduce the exact package tied to that event.
Use a document manifest
A release manifest can record the package purpose, included documents, revision of each document, approval state, release date, releasing owner, and the event it supports. If the package is later replaced, the next release references the earlier one rather than silently overwriting it.
This becomes especially useful during corrections and resubmissions, where the question is not simply “what is the latest plan set?” but “what exactly did we resubmit in response to this comment cycle?”
What should a permit resubmission packet control?
Permit corrections create one of the clearest document-control risks because several files can change together. A reviewer may request one adjustment that affects drawings, calculations, equipment documentation, signatures, or another part of the packet.
A resubmission process should be able to reconstruct the correction cycle without relying on email history.
At minimum, the team should be able to identify the original submission, the AHJ comment or correction source, the internal owner of each response, every changed document, the current revision, any required supporting document, the resubmission date, and the receipt or confirmation that proves the package was transmitted.
Do not let a corrected plan set silently invalidate other work
If the revised design changes equipment or layout, the document workflow should force the team to ask whether procurement, interconnection, install scheduling, customer scope, or other dependent work needs review. The document change is only the visible symptom. The operational impact may be wider.
This is deliberately different from a handoff checklist. A handoff asks whether the next team received what it needs. Document control asks whether the exact information being handed over is still valid for that purpose.
Field photos should be evidence, not a camera roll
Solar field teams can generate dozens or hundreds of photos across survey, installation, punch work, inspection preparation, correction work, and closeout. Uploading them all into one project folder technically stores the evidence. It does not make the evidence usable.
A useful field photo should be connected to why it was captured. That might be a survey requirement, roof condition, main service panel, equipment nameplate, serial number, conduit route, attachment detail, completed correction, installed component, inspection checklist item, or warranty condition.
The file should carry enough context to answer: which project, which site area or component, which task or checklist item, when it was captured, who captured it, and whether the evidence was accepted or needs follow-up.
The field needs the current plan, and inspection needs proof of the installed work
NREL’s 2023 SolarAPP+ performance review found that, among identified inspection failures in its dataset, a combined 17% were related to the installation not matching the SolarAPP+ plan or the inspection checklist not being on site. That is not an industry-wide inspection failure rate, but it illustrates how field execution and current project documentation can collide at inspection.
The operational lesson is simple: a crew should not need to decide whether the PDF saved to somebody’s phone is still the approved field basis. The current released package should be obvious, and superseded versions should be difficult to use accidentally.
Contracts and change orders need their own document logic
Contracts are different from plan sets because the main risk is not usually which drawing should the crew build. The risk is whether the operating team knows the current commercial commitment.
The signed agreement establishes a baseline. Later changes may affect equipment, price, schedule, customer responsibility, scope, payment milestone, financing, or another commercial term. Those changes should not live as an informal note beside the original contract.
A project record should preserve the original agreement and then link approved change orders or amendments to the scope and financial records they changed. That way finance, operations, procurement, and customer-facing teams can see the current commercial basis without pretending the original contract itself was edited after signature.
Retention periods, signature requirements, financing rules, and legal document standards can vary. This guide does not prescribe legal retention or contracting requirements. The operating principle is to keep signed source records intact and make approved changes traceable.
Closeout files should describe the system that actually exists
Closeout is where a project changes from a delivery workflow into a long-lived asset and customer record. If the closeout package only contains the files that were convenient to collect, service teams may later be forced to reconstruct what was installed from old emails and memory.
NREL’s PV O&M guidance treats documentation as essential to future maintenance. It identifies records such as as-built drawings, specifications, site plans, photo records, electrical diagrams, equipment information, warranties, operating manuals, contracts, inspection and commissioning records, and records of changes to the system.
That does not mean every small residential project needs the exact same enterprise closeout binder. It means the final project record should be sufficient for the company’s contract, customer handoff, service, warranty, finance, and compliance needs.
Separate working files from record copies
During delivery, the team may have drafts, redlines, rejected revisions, temporary calculations, review notes, and correction packages. Closeout should not simply expose the entire working history to every future user.
Mark the final record copies intentionally. Examples may include the as-built or final accepted drawing set where applicable, final permit or inspection records, PTO or interconnection confirmation, installed equipment and serial information, warranties, manuals, approved contract changes, required customer handoff files, and the evidence finance needs to recognize the applicable milestone.
DOE’s Federal Energy Management Program also emphasizes updating documentation to as-built conditions and preserving accurate project records during commissioning and acceptance. The exact federal acceptance process is not a template for every installer, but the principle that the final documentation should match the installed system is broadly useful.
How should documents connect to finance without turning finance into a file chase?
Finance should not need to inspect every project folder to decide whether an operational billing milestone is ready for review. The workflow should identify the evidence required for that specific milestone and link it directly to the event.
For example, a company may require a defined set of installation-completion evidence before an invoice-ready state is created. Another milestone may depend on inspection, PTO, customer approval, or contract-specific documentation. Those rules vary by company and agreement.
The important document-control rule is that finance sees the source evidence attached to the event, not a screenshot forwarded from operations with no clear connection to the project record.
Give every important document five control fields
A lightweight document-control model does not need dozens of metadata fields. Start with five that change how the file is used.
- Purpose: what project decision or workflow uses this document?
- Revision: which controlled version is this?
- State: draft, in review, approved for a defined use, superseded, or record copy.
- Owner / approver: who is responsible for the file and who released it?
- Related event: which submission, correction, field task, inspection, billing milestone, or closeout package does it support?
Then add project-specific metadata only where it earns its keep, such as equipment reference, AHJ, utility, customer visibility, site location, serial number, expiration, or signature status.
A useful internal metric: controlled release coverage
Do not measure document management by gigabytes stored or files uploaded. Those numbers can rise while control gets worse.
A more useful internal metric is controlled release coverage: the percentage of active projects where each stage that needs a release package has a named current package, a clear revision basis, and no unresolved ambiguity about which documents are valid for the next action.
This is a management metric proposed for this workflow, not an industry benchmark. Companies can define the required release points around their own permit, field, inspection, finance, and closeout processes.
Track document failures, not document volume
Other useful measures include permit packets returned for missing or wrong documents, field incidents involving an outdated plan or checklist, time spent locating the current file, projects with incomplete closeout records, customer or finance delays caused by missing evidence, and how often a released document has to be withdrawn or corrected.
Those measures tell the operations manager whether the document system is protecting workflow quality or simply accumulating files.
An illustrative time-loss example
Suppose an operations team handles 40 active projects and, across permit, field, finance, and closeout work, performs three manual document checks per project in a month. If each check takes an average of four minutes to locate the file, confirm the revision, and verify that it is still valid, that is 40 × 3 × 4 = 480 minutes, or eight person-hours.
This is an example calculation, not an industry benchmark and not a Solar1 performance claim. The larger value may come from avoiding a wrong submission or wrong field release, but the cost of those mistakes varies too much to assign one universal number.
What should a solar document workflow look like?
A practical workflow can be simpler than a complex enterprise document-control system.
- Create or receive the document and assign its purpose.
- Link it to the project, stage, source event, and responsible owner.
- Run the required review and record comments against that revision.
- Approve the document for a defined purpose instead of using a generic final label.
- Add the approved revision to the relevant permit, procurement, field, customer, finance, or closeout release package.
- If a new revision replaces it, mark the old version superseded and identify the replacement.
- When the project closes, identify the final record copies that describe the delivered system and commercial history.
The workflow should make the normal path easy and the risky action hard. Opening the current field set should be easy. Accidentally using the superseded field set should be difficult.
How is Solar1 being designed around document control?
Solar1 is being built as a complete solar-specific ERP for installers and EPC companies. Its product direction includes connecting project documents to the operational records that give those documents meaning: customer scope, design revisions, permit submissions, interconnection steps, procurement, field work, inspections, finance, PTO, service, and warranty history.
For document control, the intended model is not just an attachment folder. A project-critical document should be able to carry a purpose, version, review state, approval, owner, and relationship to the workflow event it supports.
A permit submission can therefore reference a reproducible packet. A field release can point crews to the current approved basis. A correction can create a new revision without erasing the old one. Photos can be tied to checklist or issue evidence. Closeout can identify the final record set rather than asking a coordinator to assemble it from memory at the end.
Solar1 is still under development, so this describes the operating model the product is being designed around. It does not mean every document register, revision-control, packet-generation, photo-evidence, approval, offline field, or closeout capability described here is currently production-ready.
Make the current file obvious
Solar companies do not need a more complicated folder tree. They need fewer moments where someone has to ask, “Is this still the right file?”
Start with the documents that can stop the job when they are wrong: the sold scope, design basis, permit packet, current field set, inspection evidence, and closeout record. Give each one a purpose, controlled revision, approval state, and clear relationship to the project event it supports.
Then make every outdated copy visibly outdated while preserving the history behind it. The goal is not perfect filing. It is to make sure permitting submits the right package, procurement buys against the right basis, crews build from the right information, finance sees the right evidence, and service inherits a record that still makes sense after the project team has moved on.
Use the Solar Document Checklist to define the current, approved, and record documents required at each major project stage.
Steps
- Define project document purposes
List the documents that support sold scope, design, permitting, procurement, field work, inspection, finance, customer handoff, and closeout.
- Create controlled document states
Use clear states such as draft, in review, approved for a defined purpose, superseded, and final record copy.
- Assign revision and ownership
Give project-critical files controlled revisions and identify who owns the file and who can approve it for use.
- Build release package manifests
For permit submissions, field releases, and closeout packages, record exactly which document revisions were released together.
- Link photos to evidence requirements
Connect field photos to the project component, checklist, issue, inspection, or closeout condition they are intended to prove.
- Block accidental use of superseded files
Preserve old revisions for history but make the current approved file the default and clearly identify what replaced older versions.
- Create the final record set
At closeout, identify the documents that describe the installed system, commercial changes, approvals, warranties, and customer or service handoff.
- Measure document-control failures
Track missing-document returns, outdated-file incidents, incomplete closeout records, file-search time, and controlled release coverage.
Frequently asked questions
What is solar document management?
Solar document management is the process of controlling project files such as contracts, plan sets, permits, photos, utility records, inspection evidence, warranties, and closeout files. Good document control identifies the current revision, approval state, purpose, owner, and history instead of only storing files in folders.
How should solar installers manage plan set revisions?
Keep every controlled revision in history, but mark only the correct revision as approved for its current purpose. When a new version replaces an older one, the older copy should be visibly superseded and linked to its replacement so permit, procurement, and field teams do not use it accidentally.
What should be included in a solar permit resubmission package?
The exact contents depend on the AHJ and correction. Operationally, the team should be able to identify the original submission, reviewer comments, changed documents and revisions, supporting records, internal response owners, resubmission date, and proof that the corrected packet was transmitted.
How should solar installers organize field photos?
Photos should be linked to their purpose rather than stored as one camera roll. Connect them to the project, site area or component, checklist or issue, capture time, responsible person, and acceptance state so inspection, closeout, service, and warranty teams can understand what each image proves.
What belongs in a solar project closeout file?
The final set depends on the contract and project, but commonly useful records include as-built or final accepted drawings where applicable, inspections, PTO or interconnection records, installed-equipment information, warranties, manuals, approved contract changes, customer handoff documents, and service history foundations. Legal and contractual requirements should be verified for the specific project.
Is cloud storage enough for solar project documents?
Cloud storage solves access and backup, but not necessarily document control. Installers also need version history, approval state, purpose, release packages, access rules, and a clear way to distinguish current files from superseded files.



