> For the complete documentation index, see [llms.txt](https://docs.digia.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digia.tech/digia-engage/experience-guides/surveys/blocks-reference.md).

# Survey Blocks Reference

Blocks are the screens a respondent moves through inside a Survey. Choose blocks based on the answer format you need, not based on visual style.

Start with [Understanding and Building Surveys](/digia-engage/experience-guides/surveys/understanding-surveys.md) if you want the end-to-end Survey workflow before using this block reference.

***

## Prompt Blocks

<figure><img src="/files/b0QP8jv7nRi82Tm8VLBx" alt="Survey block picker showing prompt blocks"><figcaption><p>Prompt blocks cover common choice, rating, reaction, and voting inputs.</p></figcaption></figure>

| Block             | Use it for                         | Notes                                                              |
| ----------------- | ---------------------------------- | ------------------------------------------------------------------ |
| **Single-Select** | One answer from a list             | Best for clean segmentation, such as `Smooth` vs `Could be better` |
| **Multi-Select**  | Multiple reasons or preferences    | Use sparingly; too many options increase effort                    |
| **Rate It**       | Star, scale, or numeric rating     | Good for satisfaction, usefulness, and quick quality checks        |
| **Reaction Poll** | Fast emotional response            | Good for lightweight sentiment, not detailed research              |
| **Upvote**        | Let users vote for preferred items | Useful for feature ideas, topics, or priorities                    |

Common settings across prompt blocks:

* title and optional description
* answer labels
* required or optional response
* media visibility
* tag visibility
* answer layout
* answer styling

Do not repeat the same styling decision for every block. Pick a consistent Survey style and only override individual blocks when it helps comprehension.

***

## NPS Blocks

<figure><img src="/files/HMvdAJHZCgdbzA0C8eDY" alt="Survey block picker showing NPS blocks"><figcaption><p>NPS blocks are useful when the main answer is a score or sentiment.</p></figcaption></figure>

| Block            | Use it for                                 | Notes                                      |
| ---------------- | ------------------------------------------ | ------------------------------------------ |
| **Numeric 0-10** | Standard NPS or score collection           | Use when you need the classic NPS scale    |
| **Emoji Scale**  | Friendly sentiment scale                   | Good when precision matters less than tone |
| **Smiley Faces** | Quick positive, neutral, negative feedback | Best for very short Surveys                |

For NPS-style Surveys, consider branching:

| Score or sentiment | Possible next step                    |
| ------------------ | ------------------------------------- |
| Low                | Ask what went wrong                   |
| Neutral            | Ask what would improve the experience |
| High               | Thank the user or ask for a review    |

***

## Form Field Blocks

<figure><img src="/files/GZ7lV5ALK0YKc9PSSg7V" alt="Survey block picker showing form field blocks"><figcaption><p>Form fields collect typed responses.</p></figcaption></figure>

| Block          | Use it for             | Notes                                           |
| -------------- | ---------------------- | ----------------------------------------------- |
| **Short Text** | One-line open response | Use for names, short reasons, or quick comments |
| **Long Text**  | Detailed feedback      | Use after a rating or negative answer           |
| **Number**     | Numeric input          | Use when min or max validation matters          |
| **Email**      | Contact information    | Use only when follow-up is part of the flow     |

Typed responses require more effort than taps. Ask for them only when the answer is worth the friction.

***

## Welcome and Result Pages

| Block           | Use it for                   | Notes                                                                     |
| --------------- | ---------------------------- | ------------------------------------------------------------------------- |
| **Welcome**     | Introduce why you are asking | Optional; skip it for very short contextual Surveys                       |
| **Result Page** | End the flow                 | Use one or more result pages if different branches need different endings |

A result page should make it clear that the Survey is complete.

***

## Choosing the Right Block

Use this shortcut:

| If you need...           | Choose...                                   |
| ------------------------ | ------------------------------------------- |
| A clean segment          | Single-Select                               |
| Reasons or preferences   | Multi-Select                                |
| A score                  | Numeric 0-10 or Rate It                     |
| Mood or sentiment        | Emoji Scale, Smiley Faces, or Reaction Poll |
| Written detail           | Long Text                                   |
| Follow-up contact        | Email                                       |
| A ranked priority signal | Upvote                                      |

## Related Pages

* [Understanding and Building Surveys](/digia-engage/experience-guides/surveys/understanding-surveys.md)
* [Survey Branching and Logic](/digia-engage/experience-guides/surveys/branching-logic.md)
* [Survey Global Settings](/digia-engage/experience-guides/surveys/global-settings.md)