> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md).

# Group QR codes

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/groups/qr-codes.md).
{% endhint %}

A group's QR codes, which open the group's public report form, to generate the first one, download them as JPG or PDF, and copy or share the link.

![Group QR codes](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-cd7b4731e7a1f4a93014738c6490afad4f1bc826%2Fqr-codes.png?alt=media)

* **Where:** web: the QR button on a group's task list ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)) or "Group QR" in the [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md) header (dialog "Group QR Codes"); iOS: the QR button on the Details tab of Group settings, and "Group QR" in the group's task "+" menu (screen `QRCodeListVC`); Android: the QR icon and the QR card in Group settings, and the group's task menu (screen "Group QR")
* **Who:** web: anyone who can open the group's task list, and settings-access holders from the settings page. iOS and Android show the settings QR button to admins only \[[ASK-71](https://github.com/snapfix/docs/blob/main/ASK.md#ask-71-who-may-archive-or-delete-a-group-and-see-its-qr-codes)]; the iOS "+" menu item shows for everyone. Creating a code is for admins only, so for others "Generate QR" fails with the server's message. Not for asset registers.
* **Feature:** [QR forms](https://docs.snapfix.com/product/features/qr/qr-forms.md); the public form is [QR form](https://docs.snapfix.com/how-the-apps-work/screens/qr/form.md).

## Layout

### Web

A dialog at least 966 px wide, titled "Group QR Codes".

1. **"Snap QR"** (left): "Snapfix provides a free QR code for every Group.", "It is a great way to allow people to report issues or make requests, by simply scanning the QR code. No App Required.", "You can also share the QR link with these users.", "Leverage the "eyes and ears" of your team, guests/tenants or visitors." and "Contact Support if you require a custom QR form.", with a link to support. Below, the codes: each with its image, its title and description (the standard code: "Standard", "This standard QR will ask the user for some basic details and create a task"), "Download JPG", "Download PDF", and "Snap QR Link" with the public link and a copy button.
2. **"Examples"** (right): sample pictures of a sticker, a poster and a card.

With no code, the left card shows "No QR Code Available", "To generate a QR code for this group, simply click the 'Generate QR' button below" and "Generate QR".

### iOS

The screen lists the group's codes, each with JPG and PDF downloads and buttons to share the image and the link, and the example pictures. With no code it offers "Generate QR".

### Android

The screen "Group QR" shows the information text (with a mail link to support), the three example pictures, and each code with "Save to Gallery" and a PDF button.

## Inputs

None.

## Actions

| Action         | Who                  | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | API                                                                                                                                                                |
| -------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Open           | See **Who**          | Loads the group's codes.                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Web: `GET /v1/app/businesses/{businessUuid}/qr`; iOS and Android: php-apis `read_business_qr` ([QR API](https://docs.snapfix.com/engineering-reference/api/qr.md)) |
| "Generate QR"  | Admins               | Creates the group's standard code. Web adds it to the list after 1.5 seconds; the apps show it when the server answers. A group has one standard code, and no screen removes or replaces it \[[ASK-74](https://github.com/snapfix/docs/blob/main/ASK.md#ask-74-can-a-groups-qr-code-be-removed-or-replaced)].                                                                                                                                                                       | `POST /v1/app/businesses/{businessUuid}/qr` on all three ([QR API](https://docs.snapfix.com/engineering-reference/api/qr.md))                                      |
| "Download JPG" | Anyone on the screen | Web saves `group-qr-{time}.jpg`, a 1024-pixel code. iOS saves the image; Android "Save to Gallery".                                                                                                                                                                                                                                                                                                                                                                                 | -                                                                                                                                                                  |
| "Download PDF" | Anyone on the screen | Web saves `group-qr-{time}.pdf` with the code, the title, the group image and the steps "Open your Camera, and point it at the QR code.", "Tap on the ‘Link’ that is displayed on the screen. This will then open a web form." and "Complete the form to report your issue, request or feedback."; these texts are in English only. iOS renders a poster and opens the share sheet; Android draws its own page ("Generating PDF..." while it works) and opens a chooser to view it. | -                                                                                                                                                                  |
| Copy the link  | Anyone on the screen | Web: copies the link and shows "Url copied to clipboard".                                                                                                                                                                                                                                                                                                                                                                                                                           | -                                                                                                                                                                  |
| Share (iOS)    | Anyone on the screen | Shares the code's image or its link through the share sheet.                                                                                                                                                                                                                                                                                                                                                                                                                        | -                                                                                                                                                                  |

## States

* **Loading:** web shows a spinner in the code list; the apps show a wait indicator.
* **Empty:** "No QR Code Available" with "Generate QR".
* **Error:** web shows the server's message in an alert and keeps the list. iOS shows "Something went wrong" for a failed request.
* **No permission:** see **Who**. Android asks for the storage permission before it saves a PDF.
* **Offline:** loading and generating need a connection. iOS and Android check the connection before they open the screen.

## Dialogs and sheets

* **Group QR Codes** (web dialog).
* **Share sheet** (iOS: image or link) and **PDF chooser** (Android).
* **Storage permission** (Android).

## Platform differences

* **Entry:** web on the task list and in settings; iOS in settings and the task "+" menu; Android in settings and the task menu.
* **Who sees the settings button:** web: everyone with settings access; the apps: admins only \[[ASK-71](https://github.com/snapfix/docs/blob/main/ASK.md#ask-71-who-may-archive-or-delete-a-group-and-see-its-qr-codes)].
* **Reading the codes:** web uses the Laravel route; the apps use the php-apis action. Both create codes through the Laravel route.
* **Downloads:** web and iOS offer JPG and PDF; Android offers "Save to Gallery" and a PDF.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
