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

# Blocks

> Explore every form block type — short answer, long answer, email, link, choice, quiz, rich text, video, and address — and their settings.

Form blocks are the individual elements that make up a form in Claimr. You can move blocks from one page to another within the form.

## Add blocks

<Frame caption="Add block">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/add-block-modal.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=6e003e3990e2739ff7b87a8efb54ba18" alt="Add block" width="1032" height="308" data-path="images/forms/add-block-modal.png" />
</Frame>

<Steps>
  <Step title="Click + Block">
    Click the **+ Block** button.
  </Step>

  <Step title="Select the block type">
    A pop-up window will appear where you can select the block type.

    <Frame caption="Select block type">
      <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/select-block-type-modal.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=af357813635960fa1a8ae29cc5bc5e72" alt="Select block type" width="1184" height="714" data-path="images/forms/select-block-type-modal.png" />
    </Frame>

    Choose the block type that best suits the information you want to collect.
  </Step>

  <Step title="Add the block">
    Click **Add Block** to add the block to the page.
  </Step>

  <Step title="Customize the block">
    Customize the labels, placeholders, and validation rules for the block.
  </Step>
</Steps>

<Warning>
  Each page in a form must have at least one block.
</Warning>

## Blocks common structure

* **Block label:** A small label that identifies the block type (e.g., "Short answer," "Email"). This is primarily for internal organization and is not always visible to the user.
* **Field label:** The label displayed to the user, indicating what information should be entered in the block (e.g., "Your name," "Email address").
* **Input field:** The actual input field where the user enters their response.
* **Settings icon:** A gear icon that opens the block's settings menu.

Customize the labels, placeholders, and settings for each block.

## Block settings

<Frame caption="Block settings">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/block-settings-panel.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=0eabba6286f0c751d48347f542f616b0" alt="Block settings" width="758" height="334" data-path="images/forms/block-settings-panel.png" />
</Frame>

Most blocks share these common settings:

**Optional toggle:** Make the block optional or required.

**Error message:** Customize the error message displayed for invalid input.

To customize a block:

<Steps>
  <Step title="Open block settings">
    Click the gear icon to the left of the block to open the block settings menu.
  </Step>

  <Step title="Adjust settings">
    Adjust the settings as needed.
  </Step>

  <Step title="Save or delete">
    Click **Apply** to save your changes or **Delete block** to remove the block.
  </Step>
</Steps>

## Block types

Each block serves a specific purpose in collecting user information or creating interactive elements within your forms.

### Short answer

Collect short text answers from users. Ideal for fields like names, addresses, or social media handles.

<Frame caption="Short answer example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/short-answer-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=da61f9fe4c076355dfc383184633310a" alt="Short answer example" width="1036" height="184" data-path="images/forms/short-answer-block-example.png" />
</Frame>

**Regular expression settings:** Define a pattern to validate user input conforms to specific rules or formats.

**Examples**

Include a specific emoji: If you want to include a specific emoji (e.g., ✨) in the user's name, you could use a regular expression like `.*✨.*` to allow for any characters before or after the emoji.

Start with a specific word or phrase: If you want to ensure the user's name starts with a specific word or phrase, you could use a regular expression like `^YourKeyword` to match any string that begins with "YourKeyword".

**Resources**

* **Regular expression builder:** [regex101.com](https://regex101.com/)
* **AI assistants**

### Long answer

Collect longer text answers or paragraphs from users. Perfect for gathering feedback, comments, or detailed explanations. This block has common settings with an optional toggle and customizable error message text.

<Frame caption="Long answer example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/long-answer-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=622e03437d23d0605dc522264faf3a62" alt="Long answer example" width="1024" height="316" data-path="images/forms/long-answer-block-example.png" />
</Frame>

### Email

Collect email addresses from users.

<Frame caption="Email example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/email-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=1779b768e5ca1f13052d1e6d7e8d9f6e" alt="Email example" width="1042" height="198" data-path="images/forms/email-block-example.png" />
</Frame>

### Link

Collect website links from users.

<Frame caption="Link example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/link-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=8572e80c4828dbf6276a39235858edb5" alt="Link example" width="1034" height="170" data-path="images/forms/link-block-example.png" />
</Frame>

### Choice

Allow users to select from a list of options. This is great for creating multiple choice questions or offering a set of predefined answers.

<Frame caption="Choice example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/choice-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=8a9c38234897eebe55a519628371d448" alt="Choice example" width="1034" height="312" data-path="images/forms/choice-block-example.png" />
</Frame>

**Choice settings**

<Frame caption="Choice settings">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/choice-block-settings.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=02a0d8bfcc79a1f1cf1e280ca7261b4e" alt="Choice settings" width="766" height="388" data-path="images/forms/choice-block-settings.png" />
</Frame>

* **Shuffle:** Randomize the order of choices to prevent bias.
* **Allow multiple choices:** Enable users to select more than one option.
* **Optional toggle:** Make the block optional or required.
* **Use "Other" answer:** Include an "Other" option for users to provide their own answer if none of the predefined choices are suitable.

**Using scores**

* **Converting score to XP:** You can convert the user's quiz score into XP (experience points) that can be used in your Claimr campaign. To do this, enable the "Score to XP" option when configuring the Form task within your quest. To find out more information, visit [Form tasks](/tasks/form-tasks).
* **Determining the correct answer:** The choice with the highest assigned score is considered the correct answer.
* **Minimum score:** You can also set a minimum score that users must achieve on the quiz to complete the Form task.

### Quiz

Use this block to create interactive quizzes within your forms. This allows you to engage users, test their knowledge, or gather information in a fun and interactive way.

<Frame caption="Quiz example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/quiz-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=d6bff94203f603c62b307df20b0ac71f" alt="Quiz example" width="1044" height="404" data-path="images/forms/quiz-block-example.png" />
</Frame>

#### Quiz structure

**Question:** Clearly state the quiz question.

**Answer Choices:** Provide a list of possible answers for the user to choose from. Only one answer can be marked as correct.

**Score:** Assign a score to each answer choice. The choice with the highest score is considered the correct answer.

**Explanation (optional):** Add a reason for each answer choice. This explanation will be displayed to the user after they answer the question, regardless of whether their answer is correct or not.

To find out more, read our [Quizzes](/forms/quizzes) article.

### Rich text

Add a heading with rich text formatting to your form. This helps break up long forms and improve readability. Use the built-in editor to format the heading text (e.g., change font size, color, or add bolding). For more details on descriptions and tags, visit our [Descriptions: creation, usage, tags](/descriptions-creation-usage-tags) article.

<Frame caption="Rich text example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/rich-text-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=451fdc0dd81be5dd73b7114fd0e72d1b" alt="Rich text example" width="1036" height="138" data-path="images/forms/rich-text-block-example.png" />
</Frame>

### Video

Embed a video into your form to provide visual instructions or entertainment. Enter the URL of the video you want to embed.

<Frame caption="Video example">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/video-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=e08049fac9f404c4fe3c5b601ea5e347" alt="Video example" width="1032" height="686" data-path="images/forms/video-block-example.png" />
</Frame>

### Address

Collect users' wallet addresses. This is useful for campaigns involving cryptocurrency or blockchain interactions.

<Frame caption="Wallet address">
  <img src="https://mintcdn.com/claimr/h4UZiIq2A-Pqcjxf/images/forms/address-block-example.png?fit=max&auto=format&n=h4UZiIq2A-Pqcjxf&q=85&s=9d2c53f6b448899238eb4a21cba17c93" alt="Wallet address" width="1028" height="166" data-path="images/forms/address-block-example.png" />
</Frame>

By utilizing these diverse block types and their customizable settings, you can create forms that are not only visually appealing but also highly effective in gathering valuable user information and enhancing the overall campaign experience.
