# Blocks

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.&#x20;

## **Add blocks**

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FAti1W6UnBb8yVpQcHamV%2FScreenshot%202025-01-31%20at%2007.55.41.png?alt=media&#x26;token=8231f454-88b5-47bf-86d9-0a2cbe85a7f1" alt="" width="375"><figcaption><p>Add block</p></figcaption></figure>

1. Click  **+ Block** button.
2. A pop-up window will appear where you can select the block type.\\

   <figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FSoBNAaxGlhK3DkWsK05s%2FScreenshot%202025-01-31%20at%2007.11.11.png?alt=media&#x26;token=eee4fb12-64ca-4fa2-9658-4f2a7f5164b1" alt="" width="375"><figcaption><p>Select block type</p></figcaption></figure>
3. Choose the block type that best suits the information you want to collect.
4. Click "Add Block" to add the block to the page.
5. Customize the labels, placeholders, and validation rules for the block.

{% hint style="warning" %}
Each page in a form must have at least one block.&#x20;
{% endhint %}

## 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**

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F1nOfzDRcIToFQqiaUNAR%2FScreenshot%202025-01-31%20at%2007.26.08.png?alt=media&#x26;token=60c70d64-27b2-4c93-83a7-9692be190224" alt="" width="375"><figcaption><p>Block settings</p></figcaption></figure>

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:

1. Click the gear icon to the left of the block to open the block settings menu.
2. Adjust the settings as needed.
3. Click **Apply** to save your changes or **Delete block** to remove the block.

## Block types

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

### **Short answer**

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

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FmM8nuzAcIk5G9StTX3J6%2FScreenshot%202025-01-31%20at%2007.51.54.png?alt=media&#x26;token=b76ca544-2740-4641-8ce1-fffd6cc0c7a9" alt="" width="375"><figcaption><p>Shot answer example</p></figcaption></figure>

**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:** <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.&#x20;

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F8HSGPsXhNOmASzYebhGM%2FScreenshot%202025-01-31%20at%2007.52.49.png?alt=media&#x26;token=de6001db-dcf8-4671-90cc-af8e08c1b2d0" alt="" width="375"><figcaption><p>Long answer example</p></figcaption></figure>

### **Email**

Collect email addresses from users.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F9TwF4AGp6RtIb854R7FS%2FScreenshot%202025-01-31%20at%2007.54.11.png?alt=media&#x26;token=76dcf4e0-dabb-46b3-bf2c-05274b42b6b3" alt="" width="375"><figcaption><p>Email example</p></figcaption></figure>

### **Link**

Collect website links from users.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FEUC1VOL4yIWwG2t2VBzE%2FScreenshot%202025-01-31%20at%2007.55.50.png?alt=media&#x26;token=65741d17-29f4-48fa-8a5b-8c6ad9d81012" alt="" width="375"><figcaption><p>Link example</p></figcaption></figure>

### **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.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Fi3eBkoc09b9O1n2forxh%2FScreenshot%202025-01-31%20at%2008.14.36.png?alt=media&#x26;token=73bf0471-0800-4631-94d7-b60eb9de4a8f" alt="" width="375"><figcaption><p>Choice example</p></figcaption></figure>

**Choice settings**

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FCae0sIorKwqMiXs4ZSsc%2FScreenshot%202025-01-31%20at%2007.57.00.png?alt=media&#x26;token=cf0fdc48-9be1-4044-b105-21ef99b8a55a" alt="" width="375"><figcaption><p>Choice settings</p></figcaption></figure>

* **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**&#x20;

* **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](https://claimr-io.gitbook.io/claimr-help-center/tasks/form-tasks "mention")
* **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.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FW7DZW1HipBOG4bcu7AEK%2FScreenshot%202025-01-31%20at%2008.02.19.png?alt=media&#x26;token=0de857f4-4efa-4ef7-998d-8eed87ee22b8" alt="" width="375"><figcaption><p>Quiz example</p></figcaption></figure>

#### **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](https://claimr-io.gitbook.io/claimr-help-center/forms/quizzes "mention") article.&#x20;

### **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](https://claimr-io.gitbook.io/claimr-help-center/descriptions-creation-usage-tags "mention")article.

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2Fzpi768dI7aeQWEELLaqc%2FScreenshot%202025-01-31%20at%2008.25.37.png?alt=media&#x26;token=978bb674-b15c-47fe-a33b-f8b7558f3a7b" alt="" width="375"><figcaption><p>Rich text example</p></figcaption></figure>

### **Video**

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

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2FdMBXTC7kHvmXLvFZV2Ed%2FScreenshot%202025-01-31%20at%2008.26.47.png?alt=media&#x26;token=09ab2148-11fe-45a6-973e-02136bc015f5" alt="" width="375"><figcaption><p>Video example</p></figcaption></figure>

### **Address**

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

<figure><img src="https://2111509621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBtEHhi1fQEriwxTxRejw%2Fuploads%2F8B2ClVPdNswBnEWGarCp%2FScreenshot%202025-01-31%20at%2008.28.27.png?alt=media&#x26;token=53c8359d-bed0-4da4-aa86-1901af3e23bc" alt="" width="375"><figcaption><p>Wallet address</p></figcaption></figure>

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.
