Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cleanscan.io/llms.txt

Use this file to discover all available pages before exploring further.

Anyone in a facility can report an issue by scanning a QR code or tapping an NFC tag. No account, no app download, and no personal information required. The report reaches the responsible team instantly.

Who uses this flow

This flow is for building occupants, visitors, and members — anyone who notices a problem in a space and wants to flag it. You do not need to be a staff member or have any relationship with the facility or cleaning company.
Submitting an issue sends an immediate notification to the team responsible for that zone. Use this flow for real facility problems — not for testing or experimenting with the form.

How to report an issue

1

Scan the QR code or tap the NFC tag

Point your smartphone camera at the QR code on the wall and tap the link that appears. On Android, you can also tap an NFC tag directly with the back of your phone (requires Chrome or Edge).
2

The zone page opens

Your browser opens a page showing the zone name — for example, “Men’s Locker Room” or “Lobby Restroom.” You do not need to download anything or create an account.
3

Tap Report an Issue

Tap the Report an Issue button on the zone page.
4

Select an issue category

Choose the category that best describes the problem — for example, Mess/Spill, Equipment Issue, or Safety Hazard. The categories shown are configured by the facility for their specific needs.
The facility configures which issue categories appear on the scan page. Categories vary by facility type — a gym may show different options than an office building.
5

Add details (optional)

You can type a short description of the problem in the text field. If the situation is urgent, check the box labeled This is urgent to bump the issue priority.
6

Tap Submit

Tap Submit. A confirmation screen appears with a reference number. The issue is now visible in the facility dashboard, and the responsible team is notified according to the routing rules for that category.

What happens after you submit

The issue appears immediately in the facility’s dashboard. The team responsible for resolving that category of issue in that zone is notified — by SMS, email, or both, depending on how the facility has configured its alerting rules. You do not need to follow up or check back in. Urgent issues and issues in categories with immediate alerting behavior (such as Safety Hazard) trigger an SMS to the assigned team right away.

Rating a space

When you scan a tag, you can also leave a 1–5 star rating of the space. This is separate from reporting an issue — it takes one tap and captures how the space felt to you at that moment. You do not need to describe a specific problem to leave a rating.

Privacy

No personal information is collected when you submit an issue or leave a rating. Submissions are anonymous. CleanScan does not track you across zones or retain any identifying information from your device.

If the QR code does not scan

  • Make sure the QR code is clean and undamaged. Dirt, tears, or peeling labels can prevent scanning.
  • Try adjusting your lighting or distance from the code. Most cameras work best 6–12 inches away.
  • Try a different angle or position.
  • If the problem persists, notify the facility manager. They can regenerate the tag from the Tags page in their dashboard and print a replacement.

Mobile app overview

Learn how the CleanScan PWA works and what to expect on different devices.

Zones and tags

How QR and NFC tags are tied to specific zones in a facility.

Issues and submissions

How submitted reports become tracked issues and route to the right team.

Resolving issues

How team members resolve issues and attach proof from the mobile app.