On this page
AI analysis is unavailable
The photo is saved without a draft; fill in the fields yourself, or retry from the item.
- Connection. Analysis needs internet; everything else in the app works offline. Retry on Wi-Fi.
- Daily limit. The free plan allows a number of analyses per day; the message says when it resets.
- Temporary error. “Server error” or “rate limited” clear themselves, retry after a minute.
- Simulator or modified device. Requests are attested by Apple’s App Attest; a simulator or a jailbroken device is refused by design.
The draft is wrong
Edit it: the report prints your text, not the AI’s. If drafts are often off:
- Get closer. A defect that fills the frame gets a specific draft; a whole wall gets a guess.
- Give it light. Turn the torch on in dark plant rooms; avoid shooting into a window.
- Fill in Location: the next draft on the same project uses the room and the last titles.
Sync is not happening
Settings → iCloud Sync shows Local only, Syncing or the last error.
- Both devices signed into the same Apple ID, with iCloud Drive on.
- iPhone Settings → your name → iCloud → Apps using iCloud → Punch List AI is on.
- iCloud storage is not full (photos count against it).
- Large photo sets are slow on cellular; leave the app open on Wi-Fi for the first sync.
The report will not generate or share
Retry once. If it fails again, open Report options and turn Photos off to isolate the cause, or set Photo size to Medium, a project with hundreds of photos can run out of memory on older devices. Sharing needs a target app (Mail, Files, Messages) installed and signed in; Email Client needs Apple Mail configured on the device.
Pro features are locked after buying
Settings → Restore Purchases, signed into the Apple ID that bought the subscription. Purchases are per Apple ID, not per device, so sign in with the buying account on each device. With Family Sharing, the subscription must be shared in App Store settings. Manage or cancel from Settings → Manage Subscription, which opens Apple’s subscription page.
Cannot add more photos
The free plan allows 3 photos per item and 5 items per project (the sample project does not count). Pro allows 100 photos per item and unlimited items and projects. After photos on the Closure section have their own limit of three and do not count against the item’s photos.
No GPS position on photos
The position is recorded only when Settings → Reports → Record photo location is on and the app was allowed to use location: iPhone Settings → Privacy & Security → Location Services → Punch List AI → While Using the App. Imported photos keep the position they carry, screenshots and photos received in Messages usually have none. Indoors, a fix can take a moment after the camera opens; the time is always recorded.
A project or item disappeared
Check the folders: a collapsed folder hides its projects, and clear the search field. On another device, wait for sync to finish. A deleted project cannot be recovered from the app, and if it was synced it is gone from iCloud too: export a CSV + Photos zip before deleting anything you may need.
Still stuck?
Send the project name, your iOS version and a screenshot to punchlistai@niceexpress.org. Bug reports with a screenshot get fixed roughly twice as fast.