Skip to main content

​
Floor plan is not showing in the dashboard

  1. Check that an image was uploaded. In the Forager app, go to Manage Locations, find the floor node, and confirm a floor plan image is attached.
  2. A PDF is still processing. A PDF floor plan is usable immediately (in a basic image view) but takes a short time — usually seconds, occasionally a couple of minutes on a complex drawing — to finish becoming an interactive vector map. Reload the page and check again shortly.
  3. Signed URL may have expired. Refresh the dashboard page. Floor plan images load via a 1-hour signed URL — if you left the tab open for a long time, reload to get a fresh URL.

​
Pins are misaligned after replacing the floor plan

When a floor plan image is replaced, the room pin positions (recorded as fractions of the original image dimensions) may no longer match the new image if it has a different scale, rotation, or crop. Fix using the calibration flow:
1

Do not delete the old floor plan first

The calibration flow needs the old image as a reference. If the old image is still attached, Forager will offer a calibration step automatically when you tap the upload button.
2

Tap the floor plan upload button

In Manage Locations, tap the floor plan icon on the floor node. If positioned rooms exist, you will see a “Replace Floor Plan?” warning. Tap Continue.
3

Tap two reference points on the old image

The calibration screen shows the current floor plan. Tap two points you can identify on both the old and new image — room corners, door frames, or landmarks work well.
4

Select the new image and tap the same two points

Pick the new image from your device. Tap the same two reference points on the new image.
5

Review the preview and confirm

The app shows a preview of the transformed pin positions over the new image. If they look correct, tap Confirm.

​
Deleted the old floor plan before calibrating

If the old image was deleted before running calibration, the reference is gone and automatic pin alignment is not possible. When you upload a new floor plan, the app will show a “Room Positions May Be Stale” warning. Tap Upload Anyway, then re-pin each room manually using the floor plan survey tap-to-pin flow.

​
Floor plan image looks blurry or low quality

Floor plans render best at 2000px or wider on the longest side. If the image looks blurry at full scale, upload a higher-resolution export of the floor plan.

​
Rooms not appearing on the floor plan

Rooms only appear as pins if they have been pinned on the floor plan. Open Survey Mode, select the floor, and use the tap-to-pin interface to place each room. Rooms that have been created in the location hierarchy but not yet pinned appear in the “Rooms without map position” list below the floor plan in the dashboard.

​
PDF floor plan never becomes an interactive map

A PDF stays in the basic image view (rather than upgrading to a sharp vector map) when Floorline can’t confidently detect walls and rooms in it. This is most common with:
  • Photos of a physical space, rather than a drawing
  • Heavily hand-marked-up or annotated scans
  • Very low-resolution or low-contrast scans
This isn’t an error and doesn’t block anything — the floor plan is still fully usable for pinning and viewing assets. If you’d like to try for a sharper result, re-scan or re-export the drawing at higher resolution and re-upload it. See Floor Plan Processing for more on how this works.

​
Some interior rooms are missing on an otherwise-working vector floor plan

If the floor plan shows the correct overall building shape and major rooms but is missing some interior detail (a suite shows as one open area instead of individual rooms), the source drawing likely has very thin or low-contrast interior walls that are harder for Floorline to distinguish from background. Try re-exporting the PDF at a higher resolution, or re-scanning at higher DPI, and re-uploading.