Field Types
Text Field
Text field for single-line names, short messages, or reference codes. Supports character limits and required validation.
When to use
- Name for engraving
- Short gift message
- Order / PO reference numbers
The recipient-name text field on the Personalized Gift Box demo product — captured on the live Smart Add-Ons demo store.
Settings reference
| Setting | Description |
|---|---|
| Field label | The title customers see above the input. |
| Placeholder | Hint text shown inside the empty input. |
| Description | Optional help text shown below the field label on the product page. |
| Required field | Customers must enter text before adding the product to cart. |
| Validation rules | Minimum length, Maximum length, Format (Any text, Email address, Whole number, Number with decimals) and an optional Custom pattern (regex). |
| Price type | Fixed amount, Percentage of product price, or Formula (Pro plans). The price is applied when the customer enters any text. See Pricing. |
| Quantity pricing | Per product quantity multiplies the price by the quantity ordered. Flat fee (once per line item) charges it once. |
| Min / Max product qty | Apply the add-on price only when the product quantity is in this range. Leave the maximum empty for no limit. |
| Conditional logic | Tick Enable conditional logic to show or hide this field based on another field in the same group. See Conditional logic. |
Order item meta
The entered text is stored on the order item:
Field label: "Engraving name"
Value: Alex
Price: +0.00Tips
- For longer messages, use Textarea.
How to add a text field
- In WordPress, go to Smart Add-Ons → Add-On Groups and open a group, or click + Add group.
- Click + Add field.
- Enter a Field label and set Field type to Text.
- Optional: add a Placeholder such as “Name to engrave” and a Maximum length under Validation rules.
- Under Pricing, leave the price at 0 for a free field, or enter a Fixed price charged when the customer types something.
- Click Save group, then open a product the group applies to and check the field.
Example: engraving name with a 20-character limit
A jeweller adds a text field labelled “Engraving name”, sets Maximum length to 20 and a Fixed price of 8. A customer who leaves it empty pays nothing extra. A customer who types “Alex” pays the product price plus 8, and “Engraving name: Alex” appears in the cart, the order emails and the admin order screen. To show the field only after an “Add engraving” checkbox is ticked, add a conditional rule on the text field.
Text field FAQ
Can I charge per character typed?
No. A text field’s price is charged once when the field is filled in, not per character. For price by length, use a dropdown or radio field with tiers such as “Up to 10 letters” and “Up to 20 letters”.
Can I limit the text to numbers or an email address?
Yes. Under Validation rules, set Format to Whole number, Number (decimal allowed) or Email address, or enter a custom regex pattern. The check runs again on the server when the product is added to the cart.
Can a text field be used in a pricing formula?
Only if the customer types a number. In a {field:ID} formula, a numeric text value is used as that number, and any other text counts as 0.