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

# Fill in blank

> Type answer letter by letter Wordle-style

## Description

In **Fill in blank** questions, participant types the answer letter by letter in boxes - similar to Wordle game. System automatically checks correctness.

## When to use

<Check>
  * Vocabulary learning (foreign languages)
  * Definitions and terms
  * Dates and numbers
  * Proper nouns
  * Formulas and equations
</Check>

## Creating a question

<Steps>
  <Step title="Select type">
    **"Add question"** → **"Fill in blank"**
  </Step>

  <Step title="Enter text with answer in braces">
    Place answer in `{braces}`:

    ```
    The capital of France is {Paris}.
    ```

    System automatically detects "Paris" as the answer.
  </Step>

  <Step title="Configure options">
    * ☐ **Case sensitive** - "Paris" ≠ "paris"
    * ☐ **Alternative answers** - add synonyms
  </Step>

  <Step title="Set parameters">
    * **Time**: 20-45 seconds
    * **Points**: 1000
  </Step>
</Steps>

## Participant view

Participant sees:

```
The capital of France is _ _ _ _ _.
                        [P][A][R][I][S]
```

1. Question text with empty boxes
2. Keyboard (on phone) or text field
3. Boxes fill as they type
4. Timer

## Configuration options

### Case sensitivity

| Option             | "Paris" vs "paris" |
| ------------------ | ------------------ |
| Disabled (default) | ✅ Both correct     |
| Enabled            | ❌ Only "Paris"     |

<Tip>
  Enable for proper nouns (cities, people) where capitalization matters.
</Tip>

### Alternative answers

Add synonyms or spelling variants:

> **Question:** "The largest mammal is the `{blue whale}`."
>
> **Alternatives:** "humpback whale", "whale"

## Scoring

| Answer         | Points |
| -------------- | ------ |
| Correct (fast) | 100%   |
| Correct (slow) | \~50%  |
| Incorrect      | 0%     |

<Info>
  No partial credit - answer must be fully correct.
</Info>

## Best practices

### Answer length

<Tip>
  * **Optimal**: 4-12 characters
  * **Maximum**: 20 characters
  * Shorter = easier, longer = harder
</Tip>

### Question content

* Context should unambiguously indicate answer
* Avoid questions with multiple possible answers
* Provide letter count hint (optional)

## Examples

### Good example

> "Photosynthesis occurs in `{chloroplasts}`."

### With hint

> "Capital of Japan is \_ \_ \_ \_ \_ (5 letters)." → **Tokyo**

### With alternatives

> "Author of 'Romeo and Juliet' is `{William Shakespeare}`."
>
> Alternatives: "Shakespeare", "W. Shakespeare"

## Special character handling

| Character           | Handling                           |
| ------------------- | ---------------------------------- |
| Spaces              | Shown as gap between boxes         |
| Accented characters | Fully supported                    |
| Numbers             | Supported                          |
| Punctuation         | Ignored or required (configurable) |

## Next steps

<CardGroup cols={2}>
  <Card title="Match" icon="puzzle-piece" href="/en/questions/match">
    Fill gaps from list
  </Card>

  <Card title="Single choice" icon="circle-dot" href="/en/questions/single-choice">
    When answer is hard to type
  </Card>
</CardGroup>