Bit Form – Currency field

The Bit Form Currency field is a feature in the Bit Form form builder that allows administrators to add a field for users to input currency values in a form. With this field, users can input monetary values in their desired currency, making it suitable for various types of forms such as payment forms, donation forms, and order forms. Administrators can customize the appearance and behavior of the Currency field, including setting the default currency, formatting options, and validation rules.

⚙ General Settings

1. Field Key

In Bit Form, every field has a special identifier known as a Field Key. This field key uniquely identifies a field, it also helps to send data via email, PDF, store database, and PHP action hook. These keys are important in Success/Error Messages, WebHooks, Redirect Pages, Email Templates, Workflows, and Integrations.

2. Name

The Name is an HTML equivalent input field’s name, you can customize it easily according to your preferences. You can easily modify it to suit your needs.

A field’s name is like a special label used when you submit a form. For example, let’s say the field name is “text-1-5”. In this case, ‘text’ tells us the type of field it is, ‘1’ refers to the form ID, and ‘5’ means it’s the fifth-number field on the form. This field name can be used for various purposes such as Fetch data from url parameter.

3. Field Label

You can set a proper name for the field that is considered a field label. This label name will appear on the front end of the form you will display. You can hide the field label if you want.

1. Adding Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the field label. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.

4. Subtitle​

The subtitle is an additional piece of text that appears below the label of a field in a form. It offers further clarification or context to help visitors understand the purpose of the field.

1. Adding Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the subtitle. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.

5. Admin Label

This field is designated for administrative use and allows an administrator to set a label name that will be displayed on the responses page.

6. Size & Position

It typically refers to the dimensions and placement of an input or output field within a user interface. It specifies the width and position, x-position, and w-width of the field on the screen or page.

7. Placeholder

A Placeholder is a property by which the user can understand the usage of the field. Any text entered on the placeholder will be displayed on the fields. The placeholder text will disappear when the user starts writing on the field.

8. Helper Text

It offers further clarification or context to help visitors understand the purpose of the field. This option allows you to guide your user on what kind of information should be entered, any restrictions on the input, and any formatting requirements.

1. Adding Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the helper text. It serves as visual cue to help users understand the context of the text. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.

9. Required

The Required Field option allows you to make a form field mandatory for the user to fill out. You can also specify an error message to be displayed if the field is left blank. With the “Custom Error Message” option, you have the flexibility to customize the error message according to your needs. Additionally, you can add Leading and Trailing Icons to the error message for better visual representation.

1. Adding Leading and Trailing Icons: The leading and trailing icon option allows you to add a symbol or image at the beginning (leading) or end (trailing) of the error message. With Bit Form, you can access over 10,000 icons from various open-source libraries and upload a custom icon to suit your specific needs.
2. Asterisk Position: The asterisk symbol position indicating a required field can be set with this option. You can choose to display it before or after the field label and on the right or left side of the field.

10. ReadOnly

The read-only field option makes it possible to show information to visitors without giving them the ability to modify it. Visitors can only view the information and not edit it. This is helpful in cases where you want to display important information that should remain unchanged. By setting the field as read-only, the information remains unaltered and accurate.

11. Disabled

The disables field option disables user input and interaction, ensuring the accuracy and integrity of form data by preventing the visitor from entering or changing any information in the form.

12. Hidden

This option allows you to make the field hidden when the form is displayed on the front end.

13. Input Amount Range(Min/Max)

This allows administrators to define a minimum and maximum value for the input amount range. Users will only be able to enter currency values within this specified range. If the limit is exceeded, administrators can configure an error message to be displayed as well as customize the message to your specific needs.

Minimum amount: By using this option, administrators can set a minimum amount that can be input by users. If a user enters an amount below the specified minimum, the administrator can configure an error message to be displayed, and customize the message according to their specific requirements.

Maximum amount: By using this option, administrators can set a maximum amount that can be input by users. If a user enters an amount above the specified maximum, the administrator can configure an error message to be displayed, and customize the message as per their specific needs.

14. Input Format Options

Input Formatter refers to the way data is formatted and displayed in an input field. There are two types of input formats available: Browser and Custom.

Browser: This option allows the user to input the amount with the default format of their browser, without the need for manual formatting.

Custom: This option requires the user to enter the amount with a specific format, such as 20.00, and the user must manually include any additional formatting, such as trailing zeros.

Currency Symbol: By disabling this option, the currency symbol will be show

Round to Closest Integer: It automatically rounds the input value of a currency field to the nearest whole number, by enabling this option. For example, if the input is $9.75, it will be rounded to $10.

Round to Closest Fraction Digits: This option rounds off a numerical value to a specific number of decimal places. For instance, the value 3.453 would be rounded to 3.45 when rounded off to two decimal places.

Minimum and Maximum Fraction Digits: This option refers to the range of digits allowed after the decimal point in a numerical value. The minimum fraction digit specifies the minimum number and the maximum fraction digit specifies the maximum number of digits that must be displayed after the decimal point. For example, if the minimum fraction digit is set to 2 and the maximum fraction digit is set to 4, a value such as 3.4567 would be rounded to 3.46, as it exceeds the maximum allowed number of digits after the decimal point.

Decimal Separator: need to know

Symbol Position: This option allows the admin to place the currency symbol relative to the numerical value in a currency field. If the current position is set to “left”, the symbol will appear on the left side of the value (e.g., $20.00), whereas if it is set to “right”, the symbol will appear on the right side (e.g., 20.00€).

Symbol Position:

1. Left (Symbol precedes the number)
2. Right (Symbol follows the number)
3. Left with Currency (Symbol precedes the number, with currency code displayed next to it)
4. Right with Currency (Symbol follows the number, with currency code displayed next to it)

15. Value Format Options

Value Formatter refers to the way data is formatted and displayed in an input field. There are two types of input formats available: Browser and Custom.

Browser: This option allows the user to input the amount with the default format of their browser, without the need for manual formatting.

Custom: This option requires the user to enter the amount with a specific format, such as 20.00, and the user must manually include any additional formatting, such as trailing zeros.

Currency Symbol: By disabling this option, the currency symbol will be show

Round to Closest Integer: It automatically rounds the input value of a currency field to the nearest whole number, by enabling this option. For example, if the input is $9.75, it will be rounded to $10.

Round to Closest Fraction Digits: This option rounds off a numerical value to a specific number of decimal places. For instance, the value 3.453 would be rounded to 3.45 when rounded off to two decimal places.

Minimum and Maximum Fraction Digits: This option refers to the range of digits allowed after the decimal point in a numerical value. The minimum fraction digit specifies the minimum number and the maximum fraction digit specifies the maximum number of digits that must be displayed after the decimal point. For example, if the minimum fraction digit is set to 2 and the maximum fraction digit is set to 4, a value such as 3.4567 would be rounded to 3.46, as it exceeds the maximum allowed number of digits after the decimal point.

Decimal Separator: need to know

Symbol Position: This option allows admin to the place the currency symbol relative to the numerical value in a currency field. If the current position is set to “left”, the symbol will appear on the left side of the value (e.g., $20.00), whereas if it is set to “right”, the symbol will appear on the right side (e.g., 20.00€).

Symbol Position:

1. Left (Symbol precedes the number)
2. Right (Symbol follows the number)
3. Left with Currency (Symbol precedes the number, with currency code displayed next to it)
4. Right with Currency (Symbol follows the number, with currency code displayed next to it)

16. Search Placeholder

By this option, the admin can add/edit a search placeholder text for the field. The placeholder text will disappear, and the search results will be displayed.

17. Currency Not Found Text

This option allows the admin to customize the text that is displayed when the user searches for a currency that is not found. By default, the text displayed is “No Currency Found”, but you can modify it to your liking.

18. Show Selected Flag Image

Enabling this option will display the flag image of the selected country on the left side of the field.

19. Selected Currency Clearable

This option allows users to clear the selected currency from the field. By enabling this option, a small “X” button will appear on the right side of the field, allowing the user to easily remove the selected option. If disabled, the user will not be able to clear the selected country from the field.

20. Search Clearable

This option allows the user to clear the search. There is a small “X” icon within the search box, allowing users to easily clear their search with a single click and start a new one.

21. Option Flag Image

Enabling this option will display the flag image of each country next to its name in the dropdown options. If you disable this option, only the name of each country will be displayed without any flag image.

22. Options List Height

This option allows the administrator to set the maximum height of the dropdown list. By setting a maximum height, the dropdown list will only display a certain number of options at once, and the user will be able to scroll through the remaining options if needed. Administrators can set the height of the options list in pixels (px)

23. Edit Options

This option allows administrators to customize the label and list of countries by adding them as per their requirements. They can also set the default Currency, disable or hide specific countries in the list, and make other modifications as per their preferences. Also, the admin can reorder the options by Dragging and Drop