> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assetinfinity.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Public reporting links

> Links and QR codes anybody can report a fault through without signing in — where each report lands, what it becomes, and what came through.

**Administration → Public reporting links** is where you make the links that let anybody report a fault without an account — a visitor, a tenant, a student or a contractor standing next to a broken machine with a phone — and where you see everything that came through them. Every other way in to the product takes a report only from somebody it can name; a poster on a washroom door or a sticker on a vending machine is read by people who will never have a login and should not need one.

Each link is printed as a QR code on a poster or an asset label, or put on your own website as a "report a problem" link. A report made through it arrives as a [work request](https://docs.assetinfinity.ai/work/requests.md) waiting for triage. Nothing is done until somebody in your organisation decides it should be.

> [!NOTE]
>
> The screen is part of the work requests module. If you don't see it in your navigation, your administrator can switch the module on under **Administration → Modules**, or it may not be included in your plan.

## Who can use this screen

Opening the screen takes **View public reporting links and their posters**. Making a link takes **Add public reporting links and their posters**, and changing one — including **Edit** and **New address** — takes **Edit public reporting links and their posters**. These are the screen's own permissions; a role that could change configuration before they were separated keeps the same reach here. See [roles](https://docs.assetinfinity.ai/setup/roles.md).

![Public reporting links, with three links: the gatehouse poster switched off and two buildings taking reports, each with its address and QR code](https://mintcdn.com/assetinfinity/udeSZdo6GrMzCT0l/images/admin/public-reporting-light.png?fit=max\&auto=format\&n=udeSZdo6GrMzCT0l\&q=85\&s=c04b26e98511c40e7ced1384453a1138)

The header counts the **reports** that came through and how many were **refused**.

## Links

Every link is listed with its name, a pill saying whether it is **taking reports** or **switched off**, where its reports land — the site, place and asset — and **filed as** the person it files reports as. Beside it are its QR code, with **Download QR code** to save the code as an image for a poster or a sticker, and its **Address** to copy onto a web page.

**New link** starts one; **Edit** changes one. When there are none yet, the section reads **No links yet**.

| Section | Field | What it means |
| - | - | - |
| **What this link is for** | **Name** | What the link is for, in the list and at the top of the page a reporter sees — "Building B washrooms", "Report a fault in the canteen". Required |
| **Where reports land** | **Site** | The site a report through this link belongs to. Required: somebody without an account has no access to decide where a report goes, so the link decides before anybody scans it |
| | **Place** | The room, floor or area the link is posted in, if it is posted in one. Leave it empty for a link that serves the whole site |
| | **Asset** | The one asset the link is stuck to, if it is stuck to one. A report through it is about that asset |
| | **Asset labels may name their asset** | Turn on to print this one link on many asset labels, each naming its own asset. A report from a label is about the asset on it, as long as that asset is at this link's site (and in its place, where one is named). A link stuck to one asset cannot also do this |
| **What a report becomes** | **File reports as** | The person whose permissions a report is raised with. They must be able to raise work requests at this site. The request still names whoever reported it as its requester. Required |
| | **Category** | The [request category](https://docs.assetinfinity.ai/config/work-requests.md#request-categories) a report starts in. Triage can change it |
| | **Severity** | What a report is assumed to be until somebody triages it — low, medium (the default), high or critical. The person reporting cannot set it |
| | **Accept photographs** | Lets a reporter attach photographs of the fault. On by default. Turn it off where a photograph could show something that must not leave the building |
| **Availability** | **Active** | A report through an inactive link is refused with a sentence saying the link is closed, and recorded, so you can see who is still using an old poster |

### Printing a link on asset labels

With **Asset labels may name their asset** on, a link printed on asset labels carries each asset with it, so one link serves a whole register of stickers rather than one link per asset. The screen reminds you: "Asset labels print this link with their own asset added: choose "Public reporting link" when designing a label." On a label, **Public reporting link** prints the link stuck to that asset if there is one; otherwise the link for the asset's site whose labels name their asset, preferring the one for the most specific place that holds the asset. A label for a place prints a link posted in exactly that place. Only active links are printed. See [labels](https://docs.assetinfinity.ai/config/labels.md).

### Giving a link a new address

**New address** asks "Give this link a new address?" and, with **Give it a new address**, replaces the address and its QR code. Every printed copy of the old one stops working at once, and you will need to print the new one. Use it when a link has been posted somewhere it should not be, or is being misused. The link's settings and history are kept.

## What came through

Every report made through these links is listed with what became of it, newest first, and the list refreshes by itself every minute. A refused report is recorded rather than dropped.

| Column | What it shows |
| - | - |
| **Arrived** | When the report arrived |
| **Link** | The link it came through |
| **What was said** | What the reporter wrote as the summary, with their name beneath |
| **Outcome** | **taken**, or why it was refused |
| **Became** | For a report taken, the work request it became, as a link. For a refused one, what to do about it |
| **From address** | The network address it arrived from. Available from **Columns** |

| Refusal | Means |
| - | - |
| **closed link** | The link is switched off and somebody is still using it — find the poster or label and take it down, or turn the link back on |
| **switched off** | Work requests are switched off for your organisation |
| **failed the check** | The check that tells a person from a script said this was a script |
| **too many** | One phone or one network sent more in an hour than is accepted. If it is a script, give the link a new address |
| **said nothing** | Nothing was written about what was wrong |
| **no name** | The reporter did not give a name |
| **wrong label** | The label named an asset that is not at this link's site or place — the label may have been printed for another link |
| **not permitted** | The person this link files reports as cannot raise them there — check their role and which sites they can reach |

When something was refused for a reason somebody in your organisation can fix — a closed link, work requests switched off, a wrong label or a person who cannot file there — a box headed **Refused for a reason somebody here can fix** above the list says what to do.

## What a reporter sees

Scanning the QR code or opening the address opens a page headed **Report a problem**, with your organisation's name, the link's name and where it is. It needs no account, and it does not use anybody's session already signed in on that browser. A link stuck to an asset, or a label naming one, shows **About** and the asset's number and name.

| Field | Notes |
| - | - |
| **What is wrong? (required)** | "For example: water leaking under the sink" |
| **Anything else that would help (optional)** | |
| **Photographs (optional, up to …)** | **Add a photograph** opens the phone's camera. Only where the link accepts photographs. Each photograph is redrawn before it is sent, so where the phone was and what it is never leave it |
| **Your name (required)** | |
| **A phone number or email, if we may contact you (optional)** | |

**Send the report** sends it. The page tells the reporter that the report goes to the people who look after the building, and that their name and contact details are seen only by them. Where your deployment uses one, the page also asks the reporter to pass a check that confirms they are a person.

Once it is taken, the page says "Thank you. Your report has been received." with the work request's number as their reference, and offers **See what happens to it** and **Copy the link** — a link to follow the report, which is shown only once. Pressing **Send the report** again after a dropped connection does not raise a second request.

The page refuses in words the reporter can act on: a closed or unknown link asks them to tell the people who look after the building another way, and several reports from one phone or network in an hour asks them to try again later or tell staff directly.

### Following a report

The link handed out after sending opens a page showing the reference, what was reported, when it was **Reported** and **Last changed**, what it was **Reported through**, and where it stands in the reporter's words:

| The request's status (defaults — see [statuses](https://docs.assetinfinity.ai/config/statuses.md)) | The page says |
| - | - |
| Submitted or in triage | Received, and waiting to be looked at. |
| Approved | Accepted. It will be scheduled. |
| Converted to a work order | Accepted, and the work has been arranged. |
| Rejected | Closed without work being raised. It may already have been reported, or not need fixing. |
| A status your organisation added | The status's own name |

Nothing else is shown — not comments, not who has it, not the work order it became. Status links stop working some months after a report is made.

## In triage

A report arrives on the [work requests](https://docs.assetinfinity.ai/work/requests.md) inbox like any other, with **Public link** as its source, the reporter's name as **Reported by**, the link's site already filled in — with its asset, or its place, where the link names one — and the link's category and severity. Triage it, convert it or reject it as usual.

> [card] [Work requests](https://docs.assetinfinity.ai/work/requests.md)
>
> Where reports are triaged and turned into work.

> [card] [Work request settings](https://docs.assetinfinity.ai/config/work-requests.md)
>
> Sources, categories and what a severity suggests.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.