Snippath

Reporting an issue

There are three ways to file a maintenance ticket in Snippath: from inside the app, by scanning a QR code on a piece of equipment, and via the public report form (no login required).

From inside the app

Any signed-in user — Tech, Manager, or Admin — can file a new ticket. From the sidebar, click New issue.

Fields:

  • Title(required) — short summary, e.g. "Walk-in freezer not holding temperature".
  • Description(optional) — anything that helps the tech understand the problem. Be specific about symptoms, when it started, what you've already tried.
  • Priority — Low / Medium / High / Urgent. Default is Medium. Urgent triggers a push to all Managers.
  • Asset(optional) — the piece of equipment this is about. Only shown if the Equipment module is enabled. Linking to an asset rolls this ticket into that asset's history.
  • Location (optional) — physical site/building/area. Only shown if the Locations module is enabled.
  • Assignee (Managers/Admins only) — assign directly, or leave blank for the manager queue.
  • Photos — tap the camera button to take a new photo or pick from your library. Multiple allowed.

Submit and you land on the ticket detail page. The ticket is immediately visible from Dashboard, All issues, and (if assigned) the assignee's My assignments.

By scanning a QR code

Snippath generates a printable QR sticker for each piece of equipment you add. Stick it on the equipment. Anyone with a phone camera can scan it to file a pre-filled report.

Generating QR stickers

  1. Sign in as a Manager or Admin.
  2. Go to Equipment in the sidebar (sidebar item only appears if the Equipment module is enabled — see Equipment & assets).
  3. Click QR codes in the top right.
  4. Select which assets to print stickers for. Each sticker shows the asset name and a QR code that links to the public report form pre-filled with that asset.
  5. Print on label paper, stick on the equipment.

What happens when someone scans

Their phone opens Safari (iOS) or Chrome (Android) to your workspace's public report URL with the asset already selected. They:

  1. Type a short description of the problem.
  2. Take a photo (optional but encouraged).
  3. Enter their name (so the tech knows who reported it).
  4. Tap Submit.

No login. The report lands in your triage queue with the asset already linked and the reporter's name on it.

Via the public report form

Anyone with the link [your-workspace].snippath.com/report can file a ticket without logging in. Useful for:

  • Stickering common-area equipment (printers, coffee machines, etc.) and letting anyone in the building report issues.
  • Customer-facing reporting — give the link to tenants in a property-management context.
  • Embedding in another internal tool via iframe or a link.

Public reports always land as Unassigned with Medium priority. A Manager triages from there.

Tips for good ticket titles

  • Start with the asset or location: "HVAC Unit 3: making grinding noise"is better than "Loud noise".
  • Describe the symptom, not the diagnosis: "Fryer 2 not heating evenly"is better than "Fryer 2 thermostat broken" (you might be wrong about the cause).
  • Mention safety / urgency only in the priority field, not the title. A 3 AM "URGENT!!!" in the title looks the same after the fix as the routine work next to it.