Textarea

Written By Floris de Vries

Last updated About 3 hours ago

The Textarea field is a multi-line variant of the Text Field. It is used to collect longer free text from the customer, for example a special request, a delivery note, or longer engraving copy. The pricing behaviour is identical to the Text Field, only the input is rendered as a multi-line <textarea> on the storefront.

Note: The Textarea is not currently exposed as a separate option in the field toolbox. New calculators use the regular Text Field for both single-line and multi-line input. Existing calculators that already contain a Textarea field continue to work without any change.


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: Special instructions


Placeholder

The Placeholder is a short example or hint shown inside the input before the customer starts typing.

Example: e.g. Engrave โ€œFor John, 2026โ€ on the inside


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: special_instructions ยท delivery_note


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 textarea when the page loads. Multi-line defaults are preserved.


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 used in formulas.

This makes it easy to charge a flat fee whenever the customer adds custom instructions.


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. The character count includes spaces and line breaks.


๐Ÿ’ก Tip:Use a Textarea for free-form copy where the customer needs more than one line. For short personalisations (a single name or word) the regular Text Field remains the better choice.