SUPPORT CENTER

Site Visits — Mobile App

1. How to Use Site Visits

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.

Site visits are the meat of SolarGrade. We use "site visits" to refer to all site visits or fieldwork instances. The site visit feature is where teams can work through a streamlined checklist that standardizes the fieldwork into reports.

These site visits are built using templates and can be customized according to each site. All site visits will display the template from which they were created in italics at the top of the page underneath the title.

App Navigation
The SolarGrade mobile app uses a bottom navigation bar with four tabs:

  • Projects — view and manage all projects
  • Site Visits — view, create, and manage site visits via a calendar view
  • Reports — access generated reports
  • Cloud Sync — manage sync status for items and photos

To access your profile, account settings, and support options, tap the profile icon in the top right corner of the screen.

Navigating Progress Within Site Visits As you work through a site visit checklist, your progress is tracked via a percentage indicator at the top left of the Form view. Each section also displays its own completion percentage badge, so you can quickly see which sections are complete and which need attention.

Sections with issues flagged will display a warning icon next to the section name.

2. Creating a Site Visit

There are two ways to create a site visit:

From the Site Visits tab:

  • Tap the Site Visits tab in the bottom navigation bar
  • You will see a calendar view showing your upcoming and past site visits
  • Tap the + Add new button in the center of the screen, or the floating + button in the bottom right corner
  • Select the desired template from your template library
  • Assign:
    • Team members (Please note: team members need to be assigned to both the project and the site visit in order to access both the project information and site visit information)
    • Date range
    • Scope

From a Project:

    • Tap the Projects tab in the bottom navigation bar
    • Select the project
    • Tap the Site Visits tab at the top of the project page
    • Tap the floating + button in the bottom right corner
    • Follow the same assignment steps above
3. Pre-Site Visit Checklist

This checklist is very important for inspectors to complete!

Solar is often built where land is cheap. You're not always guaranteed to have good cell service, or any at all. Luckily, SolarGrade works both on- and off-line. But to ensure that you're prepared for any scenario, we've developed a checklist for technicians, engineers, and anyone on-site to conduct prior to going to a job site.

  1. Open the Site Visits tab in the bottom navigation bar to see your upcoming site visits on the calendar
  2. Tap the date with a dot indicator to view site visits scheduled for that day
  3. Select your upcoming site visit
  4. From the project view, navigate to the Details tab to review project information, and tap Download to download the project drawings for offline use (note: this process will go faster if you have wifi or good service)
  5. Navigate to the Site Visits tab within the project and tap the Download button on the site visit card to sync the site visit to your device
  6. Double check that your phone has location services, camera, and photo access enabled
4. Editing Sections, Categories, and Items

Adding New

For Sections and Categories—

  • Tap the + button (dark floating button) at the top left of the item list
  • Type in the name of the new Section or Category

For Informational Items—

  • Tap the + button at the top left of the item list
  • Type in the name of the new Informational Item
  • Select the type of Informational Item:
    • Binary checkboxes — indicate confirmation and negation options
    • Multiple checkboxes — input various options
    • Date
    • Number — input options if applicable
    • Range — input range options if applicable
    • Signature
    • Text
    • Photo
    • Table — label the table
    • Progress Bar
    • Geolocation

For Issue Items—

  • Tap the pencil icon (next to the + button) at the top of the item list
  • Type in the name of the new Issue
  • Write out the new description — include what the issue is, why it's significant, and recommended next steps

Navigating Within a Site Visit

The new app uses breadcrumb navigation at the top of the Form view to show your current location within the checklist (e.g., All > Inverter > Inverter 2). Tap any level in the breadcrumb to navigate back.

Within a category, items are organized under tabs:

  • All — shows all items in the category
  • Information — shows informational items only
  • Issues — shows issue items only

Use the Expand dropdown to expand or collapse item details.

Editing Existing

All Sections, Categories, and Items can be edited or duplicated in the field.

For Sections and Categories—

  • Tap the 3 vertical dots to the left of the Section or Category title to open the edit options
  • Select the pencil symbol to edit
  • Select the double rectangle to duplicate
  • Select the trash can to delete (you will be prompted to confirm you wish to delete)

For Items—

  • Tap the 3 vertical dots to the left of the item title to open the edit options
  • Select the pencil symbol to edit
  • Select the double rectangle to duplicate
    • When you duplicate an issue, the severity, status, and description are also copied over. This leaves you free to snap a new photo and add a new location.
  • Select the trash can to delete (you will be prompted to confirm you wish to delete)
  • Select the circle arrow to clear the item and reset to the template setting

Merging Items

Accidentally created two of the same issue? No problem. Now you can merge two issues and condense all of the photos and locations into 1 issue with multiple locations. The occurrence values will be added together. You will have the option to choose which description and which severity you want for the merged issue.

To merge an issue:

  • Select the 3 vertical dots near the issue title
  • Select MERGE
  • Choose the issue you would like to merge with
  • Choose the description and severity fields you would like to include
  • Click MERGE
5. Creating an Issue — Notebook View

There are two ways to create an issue from a site visit: one using the notebook view and the other using the map view. 

In the new app, the Form tab displays the site visit checklist below the map/drawing view. Navigate through sections and categories using the breadcrumb trail at the top.

This article is designed to walk you through how to create an issue when you find a failure on-site.

  • When you find an issue item, tap the warning/yield icon in the center of the three status options (the dash icon on the left marks as N/A, the warning triangle in the center marks as fail, and the checkmark on the right marks as pass)
  • The issue will expand to show its detail fields
  • Add a location:
    • Tap the Location button to open the map/drawing view
    • You can manually drop a pin on the map or drawing by tapping the screen
    • Toggle between Map and Satellite views using the tabs at the top of the location screen
    • Use the toolbar icons at the bottom of the map for GPS location, drawing overlays, search, layers, and adding new pins
    • You can add multiple locations per one issue
  • Add photos:
    • Tap the Photo button to add photos
    • Use the app to snap new photos (with zoom options: 0.5x, 1.0x, 2.0x, 5.0x)
    • Upload photos from your camera roll (note: if you have location settings turned on for your device, you will be prompted to use that image's location as the issue location)
    • The uploading user is tagged under that photo along with a timestamp of the upload or image edit
    • You can edit photos by tapping/clicking on the uploaded photo. This will pull up an editing window where you can add shapes, text, draw, and annotate the photo. Hit SAVE to save your edits.
    • You can add a caption to the photo by selecting the caption icon on the top right corner of the photo
  • Set the Occurrence — the occurrence value will default to the number of locations tagged. However, users can add a value greater than the number of locations. For systemic issues, you will likely add a new issue or duplicate an existing issue until it is revealed to be systemic, in which case you will want to update the occurrence to 100%.
  • Review the Issue description — tap to expand and view or modify the pre-written description that states what the issue is, why it's significant, and the recommended action. Use the barcode scanner to add serial numbers of the equipment as necessary.
  • Choose the Severity level — options include Negligible, Minor, Major, and Critical
  • Assign a Prevalence — this is a way to indicate the pervasiveness of an issue without noting each location or occurrence. There are 4 options: Isolated, Prevalent, Endemic, and Systemic.
  • Choose the Status:
    • Closed — if you were able to correct in the field. Include 2 photos — one labeled "before" and the other labeled "after"
    • Open — creates an open issue for future remedy
    • Observation — for when you're not certain if it's against code, but want to flag it nonetheless. For keeping information internal — does not show as a task in the report
    • Pending Review — for when you corrected an open issue, but need an admin or manager to approve it
6. Creating an Issue — Map View

The map/drawing view is displayed at the top of the Form tab within any site visit. It shows all georeferenced issues as pins on the site layout.

You can interact with the map at any time:

  • Tap a pin once to see the name of the issue
  • Tap a pin again to be taken to that particular issue within the site visit
  • Use the + and − buttons on the right to zoom in and out
  • Use the Drawing opacity slider to adjust the transparency of the drawing overlay

Map Toolbar Icons

At the bottom of the map view, you'll find a toolbar with the following icons:

  • GPS icon — locate your position on the map
  • Drawing icon — toggle the drawing/layout overlay
  • Search icon — search for items on the map
  • Layers icon — manage map layers
  • + button — add a new issue or location from the map

Creating Issues from the Map View

To create an issue from the map:

  • Tap the + button in the map toolbar
  • Tap the location on the map where you want to place the pin
  • Select the section and category
  • Choose from existing issues in the list:
    • Tap Add location to add the pin to an existing issue
    • Tap Copy issue to duplicate an existing issue at the new location
    • Notes:
      • If an issue is blank/incomplete, you can add a location
      • If an issue is already marked as fail, you can either copy that issue or add an additional location
      • If an issue is marked as pass, you can only copy it
    • Or tap Add to new issue at the bottom to create a brand new issue at that location
  • Add a description, photos, prevalence, and any other related information
  • The issue will save automatically

Adjusting the Drawing Overlay

To adjust the visibility of the project drawing overlay on the map:

  • The Drawing opacity slider can be accessed from the map view
  • Drag the slider between 0 (fully transparent) and 1 (fully opaque) to adjust
  • Tap Apply to confirm or Cancel to discard
7. Completing & Syncing a Site Visit

This action is critical for inspectors. If the data is on your device and has not synced with the server, we do not have access to that information.

When you have completed the site visit in the field, be sure to sync your mobile device with the server.

Photos and files can now upload automatically from the mobile app, so you no longer need to tap Sync in Cloud Sync.

Auto sync

How to turn on Auto sync files

  1. In the mobile app, tap your avatar in the top right corner.
  2. Tap Settings.
  3. Toggle on Auto sync.
  4. Under Auto sync files, choose an option.
  5. Confirm when the app asks. Automatic uploads use more battery, and mobile data if you choose Wi-Fi & mobile data.

The Auto sync files setting only appears when Auto sync is on.

Auto sync files options

  • Never (default): Files upload only when you tap Sync in Cloud Sync.
  • Wi-Fi only: Files upload automatically on Wi-Fi. On mobile data, uploads wait and start on their own when Wi-Fi returns.
  • Wi-Fi & mobile data: Files upload automatically on any connection. Uses mobile data.

"Waiting for Wi-Fi" status

With Wi-Fi only selected, a site visit shows Waiting for Wi-Fi while you are on mobile data. No action is needed. Uploads start automatically once you reconnect to Wi-Fi. To upload on mobile data, switch to Wi-Fi & mobile data.

To manually sync:

  • Navigate to the site visit's Details tab
  • Sync status is displayed showing "All items synced" and "All photos synced" with checkmarks when complete

You know that you have synced properly when you see checkmarks next to both "All items synced" and "All photos synced" along with "No sync errors" on the sync Details screen.

If you encounter sync issues:

  • Tap the Cloud Sync tab in the bottom navigation bar
  • This page will show you which issues or photos have not synced
  • Use the sub-tabs (All, Projects, Site Visits) to filter sync status
8. Using Cloud Sync

The Cloud Sync page is where you can see all of the data you have on your device that is pending synchronization with the SolarGrade server. Remember to perform this process after a site visit so that photos and items get uploaded in a timely manner.

Note: If you ever encounter an error message while syncing or are unable to sync aspects of a site visit, the Cloud Sync page is also where you would see that error message and be able to sync with the server.

To access Cloud Sync:

  • Tap the Cloud Sync tab in the bottom navigation bar
  • Use the sub-tabs at the top to filter by All, Projects, or Site Visits
  • Here you should be able to see all of the pending data and easily sync the data for multiple site visits
9. A Guide for Subcontractors

Hey! You must be a subcontractor who's been asked to work in SolarGrade. This article/video is designed to get you feeling comfortable with the software.

  • To kick things off, you will need to be invited to an account by an existing SolarGrade user.
  • Once you have received your invitation via email, go ahead and click ACCEPT INVITE to create a SolarGrade account.
  • Note: you will need to create an account using this link. If you do not create one using this link, you will not have access to the shared account.
  • Once you create an account, head to the Google Play or App Store, search for SolarGrade, and download the app.
  • Use your SolarGrade credentials to log in.
  • Once in the app, make sure you're in the right account. Tap the profile icon in the top right corner to see your current account. An account is where all of a company's projects and associated work is stored.
  • If you only have one available account, it will default to that account. However, if you do subcontractor work for multiple companies using SolarGrade, tap the account name at the top of the profile menu to switch accounts.
  • Tap the Projects tab in the bottom navigation bar. This brings you to the project list. Each project card shows the address, COD, issue count, and last/next site visit dates.
  • Select the project you are working on to view project details.
  • Here you have all of your project information. These are great references as you work on-site. The project view has tabs for Details, Site Visits, Planner, and Progress Tracking.
  • From the Details tab, be sure to download the project drawings to have offline.
  • To access the site visit, tap the Site Visits tab within the project.
  • Tap the Download button on the site visit card to download the site visit to your device, so it will be available offline.
    • If nothing appears here or you're not able to make changes to your site visit, you were likely assigned to the project, but not the site visit. You will need to coordinate with someone in the company account to add you to both the project and the site visit.
  • Once in the site visit, there are three tabs:
    • Details — includes all the pre-site information (who's going, when they're going, what they're doing, etc.), the executive summary field, and buttons for Save as Template, Create Punchlist, and Generate Report
    • Form — the on-site checklist with the map/drawing view at the top and sections listed below. Navigate between sections, categories, and items using the breadcrumb trail. Here you can create issues using the notebook view and the map view.
    • Files — access project files and documents associated with the site visit
  • When you've completed your site visit, make sure to sync your device with the cloud. You can do this by:
    • Navigating to the site visit's Details tab and checking sync status, or
    • Tapping the Cloud Sync tab in the bottom navigation bar

As always, be sure to reach out with any questions.

10. Creating a Punchlist

Creating a Remediation-Only Punchlist

  • From the Projects tab, navigate to the relevant project
  • Select the Site Visits tab within the project
  • Locate the site visit from which you want to create a punchlist
  • Tap into the site visit and go to the Details tab
  • Scroll down and tap the Create Punchlist button (located next to the "Save as Template" button, above the "Generate Report" button)
  • Assign:
    • Inspectors
    • Date range
    • Scope
  • Scroll to the bottom of the page and select SAVE SITE VISIT
11. Exporting Support File

Exporting the Support File from your mobile app allows our developers to investigate what has happened in a more detailed manner. Please send all files to support@solargradestg.wpengine.com.

If you have not already spoken with a SolarGrade support member, we will reach out.

Here is how to export the support file:

  • On the mobile app, tap the profile icon in the top right corner of the screen
  • Tap Settings
  • Tap the button to "Export Support file" at the bottom of the screen
  • Please then email this file to support@solargradestg.wpengine.com
12. Notes Field

Need to leave a note for your team about access to a site? Want to give a head's up that the report is ready for review? You can now enter a short note to a site visit to notify other users of important events on-site, site visit status, and more. This field is on the Site Visit Details tab on the mobile app or at the top of a site visit on the desktop. It is a text rich field, which means you can bold, italicize, add hyperlinks, and add bullets and numbering. Once a note is added, all users with access to that site visit will see the note, the user who wrote it, and the date/time that it was added. However, any data in the Notes field is not included in the report.

To create a note:

  • Select the NOTES section
  • Add your note. This is a text rich field, so you can use bold, italics, numbering, or bullet points.
  • When you're finished, click the ADD button to add your note.
13. Adding Photos to Pass Issues

Many teams don't want their reports to only include issues of errors and failures. Many teams want to include examples of things that were done correctly on-site. Does this sound like you? Meet your newest favorite feature: adding photos to pass issues.

You can now add photos to issues that are marked as pass. To do this:

  • Mark an issue as pass by tapping the checkmark icon on the right side of the issue's status options
  • Tap the Photo button to add photos
  • Add any related photos
  • The photos will save automatically

These photos will now appear in the report in the "Issues marked as pass" category.

To opt out of including these in reports, please create a report customization. To learn more about report customizations, click here.

14. Adding Photo Geolocation Information to Issues

SolarGrade can pull the photo metadata of photos and add the latitude and longitude to the issue item.

1. Check your SolarGrade Mobile App Settings

  • In the SolarGrade mobile app, tap the profile icon in the top right corner, then tap Settings
  • Look for:
    • Geolocate camera photos — applies when photos are taken directly within the SolarGrade app
    • Geolocate gallery photos — applies when photos are selected from the phone's gallery and uploaded into SolarGrade
  • These settings should be toggled ON, depending on how photos are added

If either of these settings is turned OFF, the photos will still upload successfully but will not include GPS/location data, which prevents them from appearing as geo-referenced in SolarGrade.

2. Confirm Mobile Device Location Permissions

Please also verify that location services are enabled on the mobile device.

On the phone settings, confirm that:

  • Location services are enabled
  • SolarGrade has permission to access location
  • Location access is set to "Allow while using the app"
  • Precise location is enabled (if available on the device)

Note: After these settings are enabled:

  • Newly captured or uploaded photos will be geo-referenced moving forward
  • Previously uploaded photos will not retroactively update with location data
15. How to offload old site visits

If the SolarGrade mobile app is loading slowly, it is often due to a large number of site visits stored locally on the device. Older site visits can take up storage space and affect app performance. All synced site visits will be removed from your device after 30 days.

Offloading completed or older site visits from the device can help improve the app's speed and responsiveness.

Important: Sync Before Offloading

Before offloading or removing any site visits, always sync all pending items first. This ensures that all photos, notes, and inspection data are successfully uploaded to SolarGrade and will not be lost.

Failure to sync before offloading may result in unsaved data being removed from the device.

Option 1: First-Time Offloading (Recommended Cleanup Method)

If you have never offloaded site visits before and have many stored on your device, the easiest way to clean up your mobile app is by reinstalling it.

Steps:

  • Open the SolarGrade mobile app
  • Sync all pending site visits (check the Cloud Sync tab to verify)
  • Make sure every site visit shows as fully synced — this step is critical before continuing
  • Delete the SolarGrade mobile app from your device
  • Reinstall the app
  • Log back in to your account

After reinstalling, the app will only download the necessary data, which helps improve performance.

Option 2: Offloading Individual Site Visits

If you only have a few site visits stored on your device, you can manually offload them instead.

Steps:

  • Open the SolarGrade mobile app
  • Tap the Projects tab in the bottom navigation bar
  • Find and open the Project
  • Go to the Site Visits tab
  • If the site visit is not synced, open the site visit, sync all pending items, and return to the Site Visits list
  • Swipe left on the site visit
  • Select Unload (do not select Delete)

This will remove the site visit from your device while keeping the data safely stored in SolarGrade.

16. Why am I unable to access SolarGrade on the desktop?

If a user is unable to access the SolarGrade web app and receives a message such as "This site can't be reached", the issue is often related to the user's network connection, browser, or local device settings, rather than the SolarGrade platform itself.

This guide walks through a few quick checks that can help identify and resolve the issue.

Symptoms

You may encounter one or more of the following:

  • The SolarGrade login page does not load
  • The browser shows "This site can't be reached"
  • The SolarGrade homepage is accessible, but the login page is not
  • The issue occurs while the user is connected to a mobile hotspot

Troubleshooting Steps

Please try the following checks to help narrow down the cause:

1. Confirm if the issue affects only one user

First, determine whether the issue is isolated. Ask if other users are able to access the SolarGrade login page normally. If only one user is affected, the issue is likely related to that user's device or network.

2. Try a different browser

Have the user attempt to access SolarGrade using a different browser (Google Chrome, Microsoft Edge, Mozilla Firefox, Safari). In some cases, browser cache, extensions, or browser-specific settings can prevent pages from loading correctly.

3. Test login using the SolarGrade mobile app

Ask the user to try logging in through the SolarGrade Mobile App. If login works on mobile but not on desktop, the issue is likely browser or network-related.

4. Check if the user is connected to a VPN

If the user is connected to a VPN, this may sometimes interfere with access to the SolarGrade login page. Have the user disconnect from the VPN and try accessing the login page again.

5. Check the hotspot or network connection

If the user is connected through a mobile hotspot, the issue may be related to the network connection or DNS resolution. Try reconnecting to the hotspot, restarting the hotspot/network device, or connecting to a different Wi-Fi network if available. If the issue continues, it may help to loop in your IT team to check the network or DNS configuration.

17. Site Visit Photo Gallery

The Photos tab shows every photo in a site visit in one gallery, so managers can review the visit before leaving site.

  1. Go to the Site Visits page.
  2. Open the site visit.
  3. Tap the Photos tab.
  • Scroll vertically to move between sections and categories.
  • Scroll horizontally to browse photos within a section or category.
  • Breadcrumbs above each gallery show the section, category, and item the photos belong to.
  • Search and filter to find specific photos.

Edit a photo

Tap the edit icon in the top right corner of the photo.

  1. Tap the photo.
  2. Tap Go to issue to open the issue the photo is attached to.