Guide5 min readUpdated Jun 4, 2026

Using Drawings And PDF Pins

A drawing pin helps future viewers understand where the inspection happened. The portal stores the pin in PDF-page coordinates so it can be replayed consistently.

BYBy Team BYLT

What a pin represents

A drawing or PDF pin represents the exact inspection location on the visible drawing page. The stored coordinate is the tip of the pin, not the center of the icon.

  • The drawing is loaded from the backend content_url.
  • The pin is stored with drawing_id, x_coordinate, and y_coordinate.
  • Coordinates use PDF points from the bottom-left origin of the page.
  • Current production drawings are treated as single-page drawings.
  • The same stored point should replay without visible drift at normal UI scale.

Placing a pin during inspection

  1. 1
    Open the relevant drawing

    Choose the drawing or PDF that shows the location you are inspecting.

  2. 2
    Zoom or pan until the area is clear

    Make sure the visible drawing location is precise enough before placing the pin.

  3. 3
    Place the pin tip on the exact point

    The stored point represents the tip of the pin marker.

  4. 4
    Complete the inspection form

    The drawing location is saved together with the inspection answers and attachments.

  5. 5
    Review the saved record

    Open the inspection detail to confirm the pin appears on the expected drawing location.

Do not treat pins like screen pixels

Pins are not saved as zoom values, screen coordinates, scroll positions, or percentages. They are saved as PDF-space coordinates so the viewer can project them correctly.

When to use a pin

  • Use a pin when the record needs a precise physical location.
  • Use a pin for drawing-based review, public sharing, and later inspection lookup.
  • Do not place a pin if the form or project does not require a drawing location.