Skip to content

Positions

🐸 Introduced in Frogge v0.2

Positions are the staff roles your venue uses: bartender, host, dancer, whatever fits. They're a simple catalog: a name, an optional color, and an optional Discord role. Positions don't do anything on their own, but Events shifts are always created for a specific position, and Staffing qualifications and role grants key off a position's linked Discord role, so it's worth setting your catalog up before you build your first event or hire staff.

Quick Start

  1. Run /admin menu and pick Positions.
  2. Click Add. A new position is created immediately, named "New Position" (or "New Position 2" if that name's taken), and its detail screen opens.
  3. Click Edit next to Name to rename it, and Edit next to Color to give it a hex color (optional, leave it blank for none).

The Positions screen in Discord, listing six positions with Add, Modify, Remove, and Home buttons. → A position's detail screen in Discord, showing Name, Color, and Role fields each with their own Edit button.

  1. Open the Positions page for your venue.
  2. Type a name in the box at the bottom and click + Add Position.
  3. On the new row, pick a color with the swatch, a role from the dropdown, and adjust the name, then click Save.

The Positions page in the Dashboard, listing six positions each with a color swatch, name, role dropdown, and Save/Remove actions.

Full reference

Positions home

/admin menu → Positions shows every position currently in your catalog, plus three buttons:

  • Add: creates a new position (see Quick Start above) and immediately opens it for editing.
  • Modify: opens a dropdown of existing positions; picking one opens its detail screen.
  • Remove: opens a dropdown of existing positions; picking one asks for confirmation, then deletes it. This can't be undone.

Position detail

Shows the position's Name, Color (displayed as a hex code, or blank if unset), and Role (a Discord role, or blank if unset), each with its own Edit button that opens a small pop-up to change just that field. Color is entered as a hex code (e.g. #4ABC23) and can be left blank to clear it; Role is picked from a role select and can be cleared back to none.

Role is what Staffing qualifications and role grants actually key off: a member qualified for a position only gets that Discord role if the position has one linked here. Positions with no Role set still work everywhere else (Events shifts, Staffing qualifications without a role grant); it's optional.

Back returns to Positions home; Home returns to the main /admin menu.

The Positions page shows every position as a row: a color swatch, the name, a Role dropdown, and Save / Remove actions, plus a Clear link under the swatch when a color is set. The Role dropdown lists every Discord role by name; an Enter ID toggle switches it to a plain ID field instead (useful if the role list didn't load, or you'd rather paste an ID directly), with a refresh button to re-fetch the role list. Changes to name, color, or role are edited in place and saved with the row's own Save button. There's no separate detail screen.

Adding a position is a single name field at the bottom of the page; set its color and role afterward from its row.

  • Events: every shift belongs to a position from this catalog.
  • Staffing: qualifications and hiring reference a position's catalog entry, and a position's linked Discord role is what actually gets granted on qualification.