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

# Items and QR codes

> Add what your customers wait for and generate its QR code for subscriptions.

An **item** is what people wait for at your unit: a product, a dish, a slot, a class. Each item has its own subscribers, its own QR code, and a public link.

> [!NOTE]
>
> Creating items requires the **Create items** permission. Editing, archiving, and changing the picture require **Edit items**. The owner has all permissions.

## Create an item

**1. Open Items and click New item**

If your chain has a [catalog](https://docs.needalert.app/en/establishments/chain-catalog.md), pick a product under **From the catalog** to fill in the name, description, and picture. You can adjust everything before saving.

**2. Fill in the content**

**Name** and **Description** are what customers see. You can fill them in Portuguese and English: each person sees the item in their language and, if a translation is missing, in the chain's default language, which is required.

**3. Choose the alert type**

* **One-time alert:** the customer is notified once and the subscription closes.
* **Recurring alert:** the subscription stays active and the customer can be notified many times.

See the difference in [How it works](https://docs.needalert.app/en/how-it-works.md).

**4. Save**

Click **Save item**. The QR code is generated right away and **never changes**, so you can print it with confidence.

## Sensitive data

Check **Requires consent for sensitive data** when subscribing reveals health data, such as a blood type or a medical specialty. People subscribing must confirm an extra consent, and the public page says so up front.

## QR code and poster

On the item page, the **QR Code** card points to the item's public link. You can:

* **Download SVG**, for print shops and large materials.
* **Download PNG**, for social media and messages.
* **Print poster**, a ready-made page with the item name, the QR code, and the instruction "point your phone's camera".
* **Copy link**, to share by WhatsApp or email, or to add to your website.

The item's **Picture** shows on the public page and on the poster. Use JPEG, PNG, or WebP up to 5 MB.

## Follow your subscribers

The **Subscribers** column shows how many people are waiting for each item, updated in real time. On the item page, the **Subscribers** card lists who is waiting and since when. For privacy, only first names are shown.

## Item status

| Status | What happens |
| - | - |
| **Active** | Accepts new subscriptions and can receive dispatches. |
| **Paused** | The public page says the item is paused. Nobody can subscribe and you can't send alerts. |
| **Archived** | The item is retired: subscriptions are closed, scheduled dispatches are cancelled, and the QR code shows the item is no longer available. **This can't be undone.** |

To archive, use **Archive** in the list or on the item page.

> [!WARNING]
>
> Changing the alert type of an item that already has people waiting changes what happens to them on the next alert. The form warns you before saving.


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