# The submit page

Sooner or later someone tells you "Plex is broken" in a text message, and the details get lost. The submit page is a
link you can hand out so family, friends or players can file a proper ticket themselves, without your password and
without seeing anything else on your board.

## Turning it on

1. Go to **Settings → Submit page** and switch it on.
2. Copy the link it shows. It looks like `…/submit/<long random key>`.
3. Share it however you like: pinned in a Discord channel, in the family group chat, on a note by the TV.

## What people see

A short form:

1. **What do you need help with?** They pick a request type, such as General, Plex or Game servers.
2. **That type's questions:** for example "Which server?" or "What were you watching?".
3. A title and "what's wrong", up to 3 screenshots, and their name.

When they send it, they get the new ticket's number and a **status link** for it. They never see your board.

## Status links

The thank-you screen shows a link to the ticket's own status page, with a Copy button and a reminder to keep it. The
page shows:

- the ticket's title and number, when it was sent and when it was last updated;
- where it stands: **received** (still in Triage, or the column the submit page files into), **being worked on**,
  **waiting on something** (in your blocked column, or blocked by another open card) or **done**;
- once it's done, the resolution reason, such as "Fixed" or "Won't fix".

Nothing else: no description, resolution notes, work logs, columns or labels. "Last update" only moves when the
ticket moves, is completed or gets a different resolution reason, so adding a private note doesn't show up there. (It
also doesn't move when the ticket starts or stops waiting because of another card.)

You can send a status link for any ticket, including ones you filed yourself after someone texted you. Press **Status
link** in the card's sidebar to copy it. If you reach Belltower as `localhost`, set the app's address under **Settings
→ General** first, so the link works on other devices.

Status links only work while the submit page is on. Each one is signed for its ticket, so it can't be guessed or
edited to show a different ticket.

On your side it's a normal card in Triage (or the column you choose). Their answers are added below the description,
the title follows the type's pattern (say "Plex – Interstellar – stutters"), it gets the type's labels, and the history notes
"submit page (*their name*)". Each one rings the bell for admins, with [Teams](USING.md#teams) on or off, and with
[notifications](NOTIFICATIONS.md) set up you also get a message for each one.

## Request types

You start with **General**, **Plex** and **Game servers**, based on the old Discord support templates. Each type has
its own questions. You can edit, reorder, switch off or add types, and each question can be:

- short or long text;
- pick one, or pick several;
- a date and time;
- yes or no.

A type's **title pattern** builds the ticket title from the answers. `{summary}` is the title they typed, and
`{question_key}` is any of the type's questions.

A type's **labels** (Labels added to every ticket) go on every ticket filed with it, say Plex on every Plex request.
Submitters don't pick labels and never see yours. (Before 1.5.0-rc.4 a type had one "always add" label and could offer tags
for submitters to pick; upgrading keeps the "always add" label and drops the tags.)

## Keeping it tidy

- **A new link** (**New link** in Settings) replaces the old address instantly. Use it if the link ends up somewhere
  you didn't intend.
- **Reset status links** (in Settings, under the submit page) cuts off every status link handed out so far. New
  tickets get new links, and you can copy a fresh one from any card. **New link** doesn't affect status links.
- **After restoring an older backup**, links made since that backup stop working, while links from before it work
  again. If that matters to you, press **Reset status links** after the restore.
- **Limits:** each address can send 5 tickets per 10 minutes, and the page takes 30 per hour overall. Status pages
  can be opened 60 times a minute per address.
- Screenshots must be real images. A hidden field quietly catches simple spam bots.
- A wrong or old link just says "This page doesn't exist".

## Sharing it outside your network

If the link has to work beyond your LAN and tailnet (say, for players), publish it through
[Nginx Proxy Manager](REMOTE-ACCESS.md#option-b-an-https-name-through-nginx-proxy-manager) but let **only** the
submit page through. Everything else stays behind your access list.

The paths it needs are `/submit/`, `/api/public/` and `/assets/`, and status pages live under the same paths. The icons at the site root are optional. One way to
do it is a custom location for `/submit`, `/api/public` and `/assets` on the same proxy host without the access list.