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

# Survey Questions

> Customising patient survey questions

# Survey Questions

Create and manage questions for your patient feedback surveys.

## Accessing the Question Editor

Navigate to **Settings > Survey Questions** to manage your survey content.

## Response Types

Each question must have one of the following response types selected:

| Type                | Description                           | Use Case                                               |
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
| **Slider Control**  | 0-100% sliding scale                  | Satisfaction levels, pain intensity, recovery progress |
| **Multiple Choice** | Select one predefined option          | Yes/No questions, categories, specific answers         |
| **Free Text**       | Open text field for written responses | Comments, feedback, detailed explanations              |

<Note>
  Response types are mutually exclusive — each question can only have one response type.
</Note>

### Slider Control

The slider displays a horizontal scale from 0% to 100%. Patients drag the slider to indicate their response. This is ideal for measuring subjective experiences like pain levels or satisfaction.

### Multiple Choice

Patients select one option from a list of predefined responses.

<Warning>
  **Important:** When using Multiple Choice, you must add at least two response options. Surveys with fewer than two options will not display properly to patients.
</Warning>

To add response options:

1. Select **Multiple Choice** as the response type
2. Click the **Add Response Option** button that appears
3. Enter the response text and optional numeric value
4. Repeat to add additional options
5. Use the drag handles to reorder options if needed

### Free Text

Patients type their response in a text area. You can configure whether a response is:

* **Optional** — Patients can skip the question
* **Required** — Patients must provide an answer to continue

Check the **Response required** checkbox to make the text response mandatory.

## Creating Questions

<Steps>
  <Step title="Open Question Editor">
    Navigate to Settings > Survey Questions
  </Step>

  <Step title="Click Add Question">
    Click the **+** button to add a new question
  </Step>

  <Step title="Enter Question Text">
    Write your question clearly in the text field
  </Step>

  <Step title="Select Response Type">
    Choose Slider Control, Multiple Choice, or Free Text
  </Step>

  <Step title="Configure Response Options">
    * For **Multiple Choice**: Add at least two response options
    * For **Free Text**: Check "Response required" if mandatory
    * For **Slider**: No additional configuration needed
  </Step>

  <Step title="Save Question">
    Your question saves automatically when you make changes
  </Step>
</Steps>

## Standard Questions (Compulsory)

Every survey in Tesa Cloud automatically includes **3 compulsory standard questions** from the Tesa Medical Standard Survey. These questions:

* Are **automatically inserted** at the beginning of every new survey (imported, duplicated, or built from scratch)
* **Cannot be edited or deleted** — they appear with a lock icon and "Standard Question" badge in the editor
* Are used to calculate the **recovery journey score** shown on the patient's recovery chart
* Are **normalised to a 0-100 scale** for consistent scoring across all patients

### The 3 Standard Questions

| # | Question                                                                                     | Response Type   | Scoring           |
| - | -------------------------------------------------------------------------------------------- | --------------- | ----------------- |
| 1 | Rate how normal your knee feels, where 100 is completely normal and 0 is the worst possible. | Slider (0-100)  | Direct value      |
| 2 | Have you returned to your prior level of activity?                                           | Multiple Choice | Yes = 100, No = 0 |
| 3 | Have you injured the same or other knee?                                                     | Multiple Choice | Yes = 0, No = 100 |

<Info>
  Only the 3 standard questions contribute to the recovery journey score. Any additional questions you add are visible to patients and recorded, but do not affect the recovery score calculation.
</Info>

## Custom Questions

Add your own questions to gather specific information:

### Example Questions

**Slider Control:**

> "How would you rate your overall satisfaction with your recovery?"
>
> *Patient slides from 0% (not satisfied) to 100% (completely satisfied)*

**Multiple Choice:**

> "Have you returned to your normal activities?"
>
> * Yes, fully
> * Yes, partially
> * Not yet
> * Unable to return

<Tip>
  Always provide clear, distinct options. Include at least two options, and consider adding options that cover the full range of possible responses.
</Tip>

**Free Text (Optional):**

> "Please share any additional comments about your recovery."
>
> *Patient can skip or provide written feedback*

**Free Text (Required):**

> "Please describe the main concern you would like addressed at your next appointment."
>
> *Patient must provide a response to continue*

## Question Order

Reorder questions by:

1. Clicking the drag handle
2. Dragging to the desired position
3. Releasing to set the new order

## Enabling/Disabling Questions

Toggle questions on or off:

* Enabled questions appear in surveys
* Disabled questions are hidden but saved
* Useful for seasonal or study-specific questions

## Multi-Language Questions

Questions can be translated for each supported language:

<Steps>
  <Step title="Select Question">
    Open the question you want to translate
  </Step>

  <Step title="Click Language Tab">
    Select the target language
  </Step>

  <Step title="Enter Translation">
    Provide the translated question and options
  </Step>

  <Step title="Save">
    Save the translation
  </Step>
</Steps>
