Text Field

Written By Floris de Vries

Last updated 3 days ago

The Text Field is used to collect free text input from the customer, such as a name, reference, or additional information. The field itself does not directly affect the price, but its value can be used in later steps of the calculator to influence pricing or calculation logic. The field can also be set as required.


Label

The Label defines the text shown above the input field on the product page.
Use a clear and descriptive label so customers understand exactly what information is expected.

Example:
Text on product


Placeholder

The Placeholder is a short example or hint shown inside the input field before the customer starts typing.
This helps guide the customer on what kind of input should be entered.

Example:
e.g. John Doe


Key (unique ID)

The Key is a unique technical identifier for this field.
It is used internally by the calculator and can be referenced in later calculation steps.

Important rules:

  • Only lowercase letters are allowed

  • Numbers and underscores are supported

  • No spaces or special characters

Examples:
text_input
custom_name_1


Required field

When Required field is enabled, the customer must fill in this field before the product can be added to the cart.
Use this option for information that is mandatory to process the order correctly.


Numeric value (float)

This field defaults to 0.
A Text Field does not apply a price change on its own, so this value is not used directly. However, the value entered by the customer can be referenced in later steps of the calculator to apply pricing rules or conditional logic.


๐Ÿ’ก Tip:
Use Text Fields for collecting user input and combine them with calculation steps later in the calculator if the entered value should affect pricing.