1. How to Use Issues

Please note: all video tutorials might be outdated as the software continues to develop. Please reference the copy if the video appears out of date.

Issues are a way to assess the number of open issues for a particular site visit, project, or for your entire portfolio.

If an issue is marked correctly in a site visit, you should be able to assess the number of occurrences of all issues and measure this data over time.

Note: Issues can have one of four statuses — Open, Closed, Observation, or Pending Review. Issues marked as "Pending Review" are treated as open in reports and analytics.

Looking for data inspiration? Check out our SolarGrade PV Health Report to see what you can do with your SolarGrade data.

2. Using the Issue Summary Table Per Project

Using the Issue Summary Table

Every project has an Issue Summary tab with a table of all the issues found on that project site. You can filter the table with the column dropdown menus and export it to CSV to further analyze and catalog your issue data.

Previewing and Editing Issues

Click any issue in the issue summary table to open the Issue Preview sidebar. The sidebar shows everything about that issue, including status, details, photos, and history, without leaving the project page.

  • From the dashboard, navigate to the relevant project
  • Select the Issue Summary tab
  • Use the column dropdown menus to filter the table if needed
  • Click the issue you want to view. The Issue Preview sidebar opens on the right side of the page
  • Review the issue's status, details, photos, and history across multiple site visits
  • To make a quick edit, click the edit pencil button in the top right corner. When you're finished, click Save.
  • Click X to close it and return to the table

You can edit the following fields from the sidebar: status, severity, date modified, description, and photos.

Tip: the sidebar makes it easy to review issues one after another. Click the next issue in the table to update the sidebar without closing it.

3. How to Open an Issue

This action takes place during a site visit, when you are creating an issue.

  • Navigate to the relevant site visit
  • Navigate through a section and category to the issue
  • Select the yield icon to mark the issue as FAIL
  • This opens the SolarGrade issue form
  • Under the status field, the default is "Open". This means that this issue is now open
4. How to Close an Issue

There are two ways to close an issue.

From the Issue Summary table (fastest)

  • From the dashboard, navigate to the relevant project
  • Select the Issue Summary tab
  • Click the issue to open the Issue Preview sidebar
  • Under the status field, select "Closed"
  • Click Save

From a site visit or punchlist

  • Navigate to the relevant site visit or punchlist
  • Navigate through a section and category to the issue
  • Select the issue to open the SolarGrade issue form
  • Under the status field, tap the dropdown menu
  • Select "Closed". This closes the issue.
5. Analyzing Your Issues

Exporting issue data is a great way to assess and analyze the health and productivity over time. To obtain issue data:

To export issues from SolarGrade, follow these steps: 

At the portfolio level: 

  • Navigate to the projects page
  • Apply any filters you need to using the "Filter" button to the right of the search bar
  • Select the "Export" button to the right of the filter button
  • In the dropdown menu, select "Export Issues"

At the project level: 

  • From the projects page, navigate to the relevant project 
  • Select the issue summary tab 
  • Use the column headers to filter the desired information if need be 
  • Click the "Export Issues" button at the top of the issues section 

At the site visit level: 

  • From the dashboard, navigate to the relevant project 
  • Select the site visits tab 
  • Find the site visit performed 
  • Select the 3 vertical dots on the right end of that line item 
  • Select "Download Issues"
6. Creating Punchlists and Site Visits with Open Issues

Creating a Punchlist

A punchlist is created from one specific site visit and includes only the issues found in that site visit.

  • From the projects page, navigate to the relevant project
  • Select the site visit tab
  • Locate the site visit from which you want to create a punchlist
  • Without clicking on the site visit, locate the three vertical dots on the right side of that line item
  • Click the three vertical dots
  • Click “Create Punchlist”
  • Assign
    • Inspectors
    • Date range
    • Scope
  • Scroll to the bottom of the page and select SAVE SITE VISIT

Creating a Site Visit with Open Issues

To pull issues from across an entire project, rather than a single site visit, create a site visit with open issues. You can (1) filter the issues table to build a remediation checklist from multiple site visits, or (2) pull issues from previous site visits and combine them with a template to create a full site visit that carries over the site’s previous issues.

  • From the projects page, navigate to the relevant project
  • Select the issue summary tab
  • Filter the table to show the issues you want to include. You can include all issues if you like.
  • Select the issues, then click “+ Add issue(s) to new site visit”
  • Assign
    • Inspectors
    • Date range
    • Scope
  • Use the dropdown menu to Add Template Data to create a new site visit from a template while still importing the open issues 
  • Click “Create Site Visit”

To add issues to a site visit that already exists, see Adding Issues to an Existing Site Visit.

7. Adding Issues to an Existing Site Visit

You can add open issues from a project to a site visit that has already been created, rather than creating a new site visit.

  • From the projects page, navigate to the relevant project
  • Select the issue summary tab
  • Select the issues you want to add to the site visit
  • On the “+ Add issue(s) to new site visit” button, select the downward caret
  • Select “Add issue(s) to existing site visit”
  • Use the dropdown menu to select the site visit you want to add the issues to
  • Select “Add”