Text Field

The Text Field is used to collect free text input from the customer, such as a name, reference, or additional information. The field can also be set as required and can optionally apply a fee whenever the customer types something.

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, used internally by the calculator engine.

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.

Default value

The Default value pre-fills the input when the page loads. The customer can still change or clear it.

Numeric value (float)

The Numeric value (float) defines what the field contributes to formulas:

• If the customer leaves the field empty, the field’s value in formulas is 0.

• If the customer types anything and you set a numeric value (e.g. 5), that float is the value used in the formula.

Use this to charge a flat fee for personalisation (e.g. 5 for engraving once any text is provided).

Charging per character

For per-character pricing, drop the Number of characters entry for this field from the Form fields dropdown into your formula and multiply it by the price you want to charge per character.

💡 Tip:Combine the per-character helper with a Min / Max length validation in your formula or in conditional pricing rules to guard against very short or very long inputs.