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

# Creating your First Questionnaire

> Questionnaires let you collect structured data from your athletes: wellness check-ins, readiness surveys, injury screenings, or any custom form. Athletes receive questionnaires on their mobile app based on your configured schedule.

Navigate to **Questionnaires** in the sidebar to manage your forms.

## Question Types

Relay supports five question types:

| Type              | Description                                 | Example                                                              |
| ----------------- | ------------------------------------------- | -------------------------------------------------------------------- |
| **Single Choice** | Radio button selection (one answer)         | "How did you sleep?" with options Poor / Fair / Good / Excellent     |
| **Multi Choice**  | Checkbox selection (multiple answers)       | "Which areas feel sore?" with options Shoulders / Back / Legs / None |
| **Scale**         | Numeric scale with configurable min/max     | "Rate your energy (1-10)"                                            |
| **Numeric**       | Free-form number input with optional bounds | "Hours of sleep last night"                                          |
| **Text**          | Free-form text response                     | "Any comments or concerns?"                                          |

## Creating a Questionnaire

1. Click **Create Questionnaire**.
2. Enter a **title** and optional **description**.
3. Add questions using the builder:
   * Set the **question prompt** (required)
   * Select the **question type**
   * Add **help text** (optional hint shown to athletes)
   * Toggle **required** on/off
   * For Single/Multi Choice: enter comma-separated options (e.g., `yes,no,maybe`)
   * For Scale/Numeric: set min and max values
4. **Drag to reorder** questions as needed.
5. A **mobile preview** (iPhone frame) shows exactly how the questionnaire will appear to athletes.

### Keyboard Shortcuts in the Builder

| Key               | Action                      |
| ----------------- | --------------------------- |
| **E**             | Add new question            |
| **D**             | Duplicate selected question |
| **X**             | Delete selected question    |
| **K**             | Move question up            |
| **J**             | Move question down          |
| **Arrow Up/Down** | Navigate between questions  |
| **Escape**        | Deselect or close           |

## Editing Questionnaires

Click any questionnaire in your list to edit it. Changes to questions don't affect previously submitted responses. Historical data is preserved.

## Questionnaire List

Your questionnaires are displayed with:

* Title and description
* Number of questions
* Number of active assignments (badge)
* Organization filter (if you manage multiple orgs)
* Search by title

## Deleting Questionnaires

Deleting a questionnaire removes it along with all its assignments and future occurrences. Past responses are preserved for historical reference.
