Set Up the Inspection App

Overview

To set up the app, log in with your Keyhook email and password (entering a two-factor code if your account uses one) → open the menu and tap Settings → set your upload preferences → pick a Preferred maps app. Settings save as you change them, so there's no Save button.

Log in to the inspection app
1
Enter your login
On the login screen, enter the email and password you use for Keyhook — the same credentials as the web app.
2
Log in
Tap Login. If your account doesn't use two-factor authentication, the app opens straight onto your upcoming inspections list.
3
Enter your 2-factor code (if you use one)
If your account has two-factor authentication, a 2-Factor Authentication screen appears. Enter the 6-digit code from your authenticator app — the app logs you in as soon as the code is complete. Prefer a backup code? Tap Enter a backup code and type one of your 32-character codes (each backup code works only once). Lost access to your authenticator? opens an email to Keyhook support.
Open your Settings
1
Open the menu
Tap the menu icon in the top-left corner to slide open the app menu.
2
Open the Settings screen
Open the Settings screen either way: tap the Settings item (the one with the gear icon) in the menu, or tap your name at the very bottom of the menu. Both open the same Settings screen, where all the app options live.
Set how your photos and videos upload
1
Hold uploads for Wi-Fi
Switch on Upload only on Wi-Fi to hold photo and video uploads until you're on Wi-Fi, so an inspection doesn't burn through mobile data.
2
Pause uploads when you need to
Use Manually pause uploading to stop uploads for now; switch it off again to resume them.
3
Turn on the improved uploader
Switch on Use improved queueing to send media through Keyhook's newer, more reliable upload queue.
4
Free up space automatically
Switch on Auto-delete photos after upload to remove each photo from your device once it has uploaded.
5
Check what's still uploading
Pending media uploads shows how many files are still to send. When something's waiting, tap it to open the queue; when nothing's pending the row is inactive (there's nothing to show).

Note: With Upload only on Wi-Fi on, media stays on your device until you next connect to Wi-Fi — a report won't finish syncing on mobile data. With Auto-delete photos after upload on, use Backup media files (in the app menu) first for anything you want to keep, as local copies are removed once uploaded.

Back up your photos and videos
1
Open Backup media files
This one lives in the app menu, not on the Settings screen. Open the menu and tap Backup media files.
2
Pick what to back up
The screen shows every photo and video still stored on your device (newest first) — not just one inspection's. Tap thumbnails to select them, or use Select all in the header.
3
Save them to your phone
Tap the options button and choose Save. The first time, allow media-library access when prompted; Keyhook then copies the selected photos and videos into your phone's photo library.
4
Or clear local copies
Choose Delete in the same options to remove the selected files from the device. Confirm on the Delete Files prompt — this permanently deletes the local copies and can't be undone, so save anything you want to keep first.

Note: Backup media files works on the copies held on your device. Once media has uploaded (especially with Auto-delete photos after upload on) it may no longer be listed here.

Choose your preferred maps app
1
Open the maps setting
On the Settings screen, tap Preferred maps app.
2
Pick an app
In the Select Maps App sheet, choose Apple Maps, Google Maps or Waze — or None to turn it off. Your choice saves straight away and is used for every inspection.

Note: Only maps apps installed on your device appear in the list. If none of Apple Maps, Google Maps or Waze is installed you'll see "No supported maps apps found on your device."

Get directions to an inspection
1
Open the inspection
From your inspections list, open the inspection you're heading to.
2
Tap the map icon
In the property details at the top, tap the map icon beside the address. The property opens in your chosen maps app, ready for directions.

Note: The map icon stays greyed out until you've set a Preferred maps app — set one first (see above) to turn it on.

Good to know
  • The Dark Mode / Light Mode toggle at the top of Settings switches the app's theme, and is saved on that device.
  • Logout at the bottom of Settings signs you out and clears any pending media uploads — let uploads finish before you log out.
  • If you belong to more than one portfolio, a portfolio selector (All Portfolios, the portfolio name, or N Portfolios) appears in the menu just above your name — tap it to choose which portfolios' inspections you see.

Frequently asked questions

Where do I find the app's settings?

Open the menu (the icon in the top-left), then tap the Settings item (gear icon) or your name at the bottom — both open the Settings screen. Everything — theme, upload options and your maps app — lives there; there's no separate "Profile Settings" screen. (Backup media files is a separate item in the same menu, not on the Settings screen.)

Do I have to save my settings?

No. Every toggle and your Preferred maps app choice save the moment you change them, and they stay set on that device — there's no Save button.

What does "Use improved queueing" do?

It routes your photo and video uploads through Keyhook's newer upload queue, which is designed to handle background uploading more reliably. It's an optional setting — if your uploads are working fine you don't need to change it.

Why is the map icon greyed out on an inspection?

Because you haven't chosen a Preferred maps app yet, or none of Apple Maps, Google Maps or Waze is installed on your device. Set one under SettingsPreferred maps app and the icon becomes active.

Will my photos upload on mobile data?

Yes, unless you turn on Upload only on Wi-Fi. With that on, media waits until you're next on Wi-Fi before it uploads.

The app is asking for a 2-factor code — what do I enter?

If your Keyhook account has two-factor authentication turned on, after your password the app shows a 2-Factor Authentication screen. Enter the current 6-digit code from your authenticator app. No authenticator handy? Tap Enter a backup code and use one of your 32-character backup codes (each works only once). If you can't get in, tap Lost access to your authenticator? to email Keyhook support.

How do I keep a copy of an inspection's photos on my phone?

Open the menu and tap Backup media files. Select the photos and videos you want, then choose Save to copy them into your phone's photo library (allow media-library access the first time). It's worth doing this before you turn on Auto-delete photos after upload.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us