Elements

The elements are the components that make up the structure of the form, allowing data collection. In other words, elements are the types of questions available to be inserted into a form.

Important

The settings made in this step will define how the form will be presented for data collection.

Presentation of the main features for including and managing elements in the form. Click on the image to enlarge it.

1. Adding elements to the form

1. In the left sidebar Form Elements, click , available at the bottom of the sidebar;
2. Choose the desired element, which are organized into tabs: Data Entry and Display;
3. Click on the desired element and it will be included in the form.

1.1. Data Input Elements

Type	Elements	Description
Text	Single Line: text input allowing multiple lines and paragraphs; Multiple Lines: text input allowing multiple lines and paragraphs; Email: pre-formatted for email addresses; Mask: customized text input where only values specified in the mask are accepted.	Used to capture open-ended responses, such as names, addresses, comments, emails, and formatted text (e.g., CPF, RG, etc.). For this type of data entry, the following reports are generated: collection summary and response table (which can be exported in PDF and XLS). None of the text-type questions require additional configuration; that is, simply insert the question that will be displayed in the form. For Mask-type questions, it is necessary to configure the desired mask. For example, to configure a vehicle license plate input, you can use a mask in the format AAA9999, which allows 3 uppercase letters followed by 4 numbers. Learn more...
Number	Integer: input for whole numbers (no decimals); Decimal: input for rational numbers (with decimals); Quantity (Emojis): data input with emojis representing the selected quantity.	Used for numeric data entry or data that can be converted into a quantity. For this type of data entry, automatic calculations can be performed, and the following reports are generated: graphical analyses, collection summary, and response table (which can be exported in PDF and XLS).
Single Selection (multiple options, one answer)	Single Selection (Menu): options are displayed in a dropdown menu format; Single Selection (Check): options are displayed as checkboxes; Single Selection (Buttons): options are displayed as clickable buttons.	Data entry that allows selecting one option from several (multiple-choice question with only one answer). For this type of data entry, automatic calculations can be performed, and the following reports are generated: graphical analyses, collection summary, and response table (which can be exported in PDF and XLS).
Multiple Selection (multiple options, multiple answers)	Multi-selection (Check): options are displayed as checkboxes; Multi-selection (Buttons): options are displayed as clickable buttons.	Data entry that allows selecting one or more options from several (multiple-choice question with more than one answer). For this type of data entry, automatic calculations can be performed, and the following reports are generated: graphical analyses, collection summary, and response table (which can be exported in PDF and XLS).
Date and Time	Date and Time: element that allows saving date and time; Date: element that allows saving only the date; Time: element that allows saving only the time.	Used as data entry to save date, time, or both via a calendar.
Evaluation	Facial Expressions: multiple selection element with configurable facial expression emojis. Emojis: multiple selection element with emojis and configurable question quantities.	Data entry that allows selecting one option from several (multiple-choice question with only one answer), but with graphical resources (emojis). For this type of data entry, automatic calculations can be performed, and the following reports are generated: graphical analyses, collection summary, and response table (which can be exported in PDF and XLS).
Others	File Upload GPS Calculated Field (Script) Calculated Field (Formula) Sort / Prioritize Photos / Images Signature	These are special elements that enable the creation of automated fields with scripts and formulas, or for uploading files, photographs, and geolocation coordinates.

1.2. Display Elements

Type	Element	Description
Image	Image display	Element used to display an image in the form. To include an image, you can drag and drop a file or click to open a dialog box for choosing the image file.
Text	Text Display	Element used to display text in the form. When clicking , a dialog box will open with a text editor for typing and formatting the desired text.

2. Managing inserted elements

All elements included in the form are available in the left sidebar ** Form Elements**. When you click on an element of these elements, a set of options for managing them are shown. From these options you can:

• Select all;
• Move selected;
• Group selected;
• Clone selected;
• Delete selected;

3. Setting the elements

The elements added to the form are shown in the central portion of the screen, and around these elements, the following configuration options are displayed:

Option	Description
Title, question, etc.	The main text of the element can be a question or simply a title. For example, to collect a full name, you can use: Full name:
Description	Although optional, the element's description can be used to guide the response. For example, in a field to collect a full name, the following description could be used: Enter your full name without abbreviations.
Change question type (element)	Allows changing an element to other related element types after it has been added to the form. For example, change a Single Line element to an Integer element, of the Number type. Or a Multi-selection (Check) element to a Multi-selection (Buttons) element, both of the Multiple Selection type.
Conditional Actions	Conditional actions are automatically applied to form elements when certain conditions occur. They are "IF/THEN" blocks: IF (condition occurs) THEN (perform the action). Attention Conditional actions are processed ALWAYS whenever a form response is changed.
Conditional Content (Multi-content)	Allows creating multiple contents for the same question, including various response options, and choosing which content should be displayed based on configurable conditions. For example, imagine two questions: Which State? Which City? To improve the dynamics of filling out the form, we can display only the cities contained in the selected state in the city list. To do this, simply enable multi-content (conditional content) for the question "Which City?". This way, it’s possible to create a city list for each state and link the display of each list to the state selection. The same logic applies to several other scenarios, for example: Sectors, Areas ↔️ Departments Departments ↔️ People, Managers Categories ↔️ Products, Items, etc.
Answer Options	Option specific to some elements that require additional configurations, such as those allowing Single Selection and Multiple Selection.
Clone	Generates copies of the element (question). It’s possible to choose the number of clones and the position where they should be inserted in the form.
Move	Moves the element (question) to a specific position in the form.
Delete	Deletes the element (question) from the form.

3.1. Element Attributes and Content Attributes

When configuring an element inserted in the form, the settings for the element's **attributes ** and content attributes are shown in the right sidebar. See each of these settings below:

3.1.1. Element Attributes

Attribute	Description	Available Elements
Field Name	The field name must be unique (exclusive) across the entire form and is used in creating mathematical formulas for the Calculated Field (Script) element type. The field name is also used when exporting data to other systems via API, CSV, and XLSX files, and in integration with Hashdata Advanced Reports. For example: sample_weight_1, sample_weight_2, and sample_weight_3.	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and Others.
Tags	Tags are used to group questions and facilitate the creation of mathematical formulas for the Calculated Field (Script) element type. For example, to calculate the average of the weights of multiple samples, simply add a tag to each weight-related question—like this: #weight—and use that tag in the formula: avgByTag('#weight'), where avgByTag means average by tag. Learn more...	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and Others.
Allow copying response from previous collection	With this option enabled, it’s possible to copy (load) the response provided in the previous collection. This functionality is very useful when there are responses that repeat across a set of collections, such as: Date, City, State, etc.	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and the GPS and Sort / Prioritize elements from the Others type.

3.1.2. Content Attributes

Attribute	Description	Available Elements
Required Field	Indicates whether the element must be mandatorily filled out before the form can be submitted or processed. When this option is enabled, the user cannot proceed or complete the form submission without providing a valid response in the specified field.	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and the File Upload, GPS, Calculated Field (Script), Calculated Field (Formula), Sort / Prioritize, Photos / Images, and Signature elements of the Others type.
Allow Adding Comments	Enables an additional field for the element, where users can freely write a comment or observation about the question. The comment can be useful for questions that require or need additional explanations, feedback, or details that don’t fit into closed responses. When this option is enabled, the Required Comment attribute is displayed, allowing you to specify whether filling out the comment is mandatory.	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and the File Upload, GPS, Calculated Field (Script), Calculated Field (Formula), Sort / Prioritize, Photos / Images, and Signature elements of the Others type.
Allow Adding Photos	This attribute indicates whether uploading photos to the element is allowed or not. When this option is enabled, the following attributes are displayed. Learn more... Allow Photos from Gallery; Minimum Required Photos; Maximum Allowed Photos; Maximum Photo Size.	All elements of type Text, Numbers, Single Selection, Multiple Selections, Date and Time, Evaluation, and the GPS, Calculated Field (Script), Calculated Field (Formula), and Sort / Prioritize elements of the Others type.
Minimum Required Characters	Defines the minimum number of characters a user must enter in the element for the response to be considered valid. When this option is configured, the form ensures that responses provided by users meet a minimum length, preventing responses that are too short or incomplete. To configure, choose values between 0 and 4,999.	Single Line and Multiple Lines elements of the Text type.
Maximum Allowed Characters	Restricts the maximum number of characters that can be entered in a data entry element for the response to be considered valid. This feature is essential to ensure data is formatted correctly and to avoid information overload. To configure, choose values between 1 and 5,000.	Single Line and Multiple Lines elements of the Text type.
Initial Line Count	Choose values between 1 and 20.	Multiple Lines element of the Text type.
Mask	Defines a specific format for the data entry element. The mask is used to guide the user on how the information should be formatted, ensuring data is collected consistently and correctly. The following masks are pre-configured: CPF - 999.999.999-99 CNPJ - 99.999.999/9999-99 CEP - 99.999-999 Phone - (99) 99999-9999 Vehicle Plate - AAA-9999/AA 3-digit number with sign and optional two decimal places. Accepts comma and period as decimal separators. - [~]999[(,|.)99] The field is editable and allows the inclusion of custom masks. Custom Masks To configure custom masks, the following special characters can be used: 9: number a: lowercase letter (a...z) A: uppercase letter (A...Z) x: letter (lowercase or uppercase) *****: letter or number ~: positive or negative sign (+ or -) (): group block : repetition block []: optional block \: cancels the wildcard effect of the next special character (9aAx*~) It’s possible to mix special characters with other characters, for example: Serial number: PWR-999-aa9aa	Mask element of the Text type.
Show Thousand Separator	Defines whether the thousand separator should be automatically added to the element. This feature facilitates reading and understanding large numbers by organizing them into groups of three digits. As the user types a number, the thousand separator is inserted automatically in the appropriate place. For example, typing "1000000" is formatted as "1,000,000" or "1.000.000," depending on the regional format.	Integer element of the Numbers type.
Minimum Number	Determines the lowest value that can be entered in the element. By limiting the range of values a user can input in a form, it ensures the data respects a pre-established lower limit.	Integer and Decimal elements of the Numbers type.
Maximum Number	Determines the highest value that can be entered in the element. By limiting the range of values a user can input in a form, it ensures the data respects a pre-established upper limit.	Integer and Decimal elements of the Numbers type.
Prefix	A prefix is text that precedes the numeric value entered by the user, helping them understand what type of information they need to input. For example, in a monetary value field, the prefix could be: "R$ " or "USD". Recommendation Add a space after the prefix text so it doesn’t appear attached to the entered value.	Integer and Decimal elements of the Numbers type and the Calculated Field (Script) and Calculated Field (Formula) elements of the Others type.
Suffix	A suffix is text that follows the numeric value entered by the user, helping them understand what type of information they need to input. For example, in fields for units of measurement or distances, suffixes could be: "kg" or "km ". Recommendation Add a space before the suffix text so it doesn’t appear attached to the entered value.	Integer and Decimal elements of the Numbers type and the Calculated Field (Script) and Calculated Field (Formula) elements of the Others type.
Decimal Places	Defines the number of digits allowed after the decimal point in the numeric element. This feature is useful for controlling the precision of entered values, such as in financial calculations, measurements, or other entries requiring decimals. Choose between 0 and 8 decimal places.	Decimal element of the Numbers type and the Calculated Field (Script) and Calculated Field (Formula) elements of the Others type.
Show Numbers	Defines whether the numeric characters corresponding to quantities should be displayed alongside the emojis.	Quantity (Emojis) element of the Numbers type and the Emojis element of the Evaluation type.
Type	Allows changing the element to others of the same type. For example: it enables switching the Single Selection (Menu) element to Single Selection (Buttons) or Single Selection (Check), all of the Single Selection type (multiple options, one answer).	All elements of the Single Selection and Multiple Selections types.
Number of Columns	This attribute defines how options are displayed, specifically how many options will be shown per row: If the number of columns is 1, all options will be displayed one below the other (one per row); If the number of columns is 2, two response options will be displayed per row (2 columns).	All elements of the Single Selection and Multiple Selections types.
Minimum Selection	Defines the minimum number of items a user must select in a multiple selection element for the response to be considered valid. Before setting this attribute’s value, you need to configure the number of items that make up the element in Answer Options.	All elements of the Multiple Selections type.
Maximum Selection	Defines the maximum number of items a user must select in a multiple selection element for the response to be considered valid. Before setting this attribute’s value, you need to configure the number of items that make up the element in Answer Options.	All elements of the Multiple Selections type.
Minimum Date	Sets the earliest date available for selection in the element. When this option is configured, the system establishes a lower limit, preventing the selection of dates prior to the specified minimum date.	Date and Time and Date elements of the Date and Time type.
Maximum Date	Defines an upper limit for the date that can be chosen for the element. When a maximum date is set, the system restricts date selection to a period that does not exceed this limit.	Date and Time and Date elements of the Date and Time type.
Show Calendar	Defines whether the calendar should be displayed during date selection while filling out the form. When this option is enabled, a calendar, typically monthly, will be shown so the user can review dates, schedule events, or select a specific date.	Date and Time and Date elements of the Date and Time type.
Format	Defines the time display system. Choose between 12 and 24. The 12-hour format divides the day into two 12-hour periods: morning (AM - ante meridiem) and afternoon/evening (PM - post meridiem). For example, 2:00 PM indicates 14:00, or two in the afternoon. In the 24-hour format, hours are counted continuously from 00:00 to 23:59, without the need for AM or PM.	Date and Time and Time elements of the Date and Time type.
Show Seconds	Defines whether seconds should be displayed during time selection while filling out the form.	Date and Time and Time elements of the Date and Time type.
Minimum Number of Files	Defines the minimum number of files a user must upload to the element for the response to be considered valid.	File Upload element of the Others type.
Maximum Number of Files	Defines the maximum number of files a user must upload to the element for the response to be considered valid.	File Upload element of the Others type.
Allow Any File Type	When this option is enabled, any file type can be uploaded to the form. When disabled, options are displayed to define which file types can be uploaded: Allow Audio; Allow Videos; Allow Images; Allow Documents.	File Upload element of the Others type.
Allow Manual Coordinate Entry	Defines whether geographic coordinates must be obtained solely from the GPS sensor or can be manually entered during data collection.	GPS element of the Others type.
Minimum Required Precision (m)	Defines the level of accuracy required for a GPS location capture in the element. With this, the system will only accept a GPS coordinate if it meets or exceeds the specified precision level. Precision is measured in meters, and lower values indicate greater accuracy. Therefore, choose values between 100 m and 10,000 m, in intervals of 50 m.	GPS element of the Others type.
Hide Result from User	Defines whether the results of calculations performed in the element will be shown during data collection.	Calculated Field (Script) and Calculated Field (Formula) elements of the Others type.
Allow Photos from Gallery	Indicates whether uploading photos to the form from the device’s gallery is allowed. If not allowed, photos can only be uploaded from the camera during data collection.	Photos / Images element of the Others type and all elements with the Allow Adding Photos attribute.
Minimum Required Photos	Indicates the minimum number of photos that can be uploaded to the form. Choose values between 0 and 100.	Photos / Images element of the Others type and all elements with the Allow Adding Photos attribute.
Maximum Allowed Photos	Indicates the maximum number of photos that can be uploaded to the form. Choose values between 1 and 100.	Photos / Images element of the Others type and all elements with the Allow Adding Photos attribute.
Maximum Photo Size	Defines the maximum dimension, in pixels, of each photo uploaded to the form. Choose a maximum dimension from the following options: 512 x 512 768 x 768 1024 x 1024 1536 x 1536 2048 x 2048	Photos / Images element of the Others type and all elements with the Allow Adding Photos attribute.
Maximum Line Width	Defines the thickness of the signature line. Choose values between 1 and 10.	Signature element of the Others type.
Single Point Radius	Choose values between 1 and 5.	Signature element of the Others type.
Line Color	Defines the color of the signature line. Clicking the dropdown menu displays a palette of available colors.	Signature element of the Others type.
Alignment	Defines the alignment of the image in the form, whether it should be left, right, or center. Choose between: left, right, and center.	Image Display element of the Image type, belonging to Display Elements.
Image Rounding	Defines the corner rounding of the image displayed in the form. Choose values between 0 and 300.	Image Display element of the Image type, belonging to Display Elements.
Maximum Width	Defines the maximum width, in pixels, of the image displayed in the form. Choose values between 50 and 1024.	Image Display element of the Image type, belonging to Display Elements.
Shadow	Indicates whether shadowing should be displayed on the image shown in the form.	Image Display element of the Image type, belonging to Display Elements.
Show Title to User	Indicates whether the element’s title should be displayed in the form during data collection.	Text Display element of the Text type, belonging to Display Elements.