Fields โ
Fields are the individual inputs that appear on your product page. Each template contains one or more fields. VariantIQ supports a wide range of field types to cover most customization use cases.
Field Types โ
| Type | Description |
|---|---|
| Text | Single-line text input. Use for names, personalization text, short notes. |
| Textarea | Multi-line text input. Use for longer messages or instructions. |
| Dropdown | A select menu. Customers pick one option from a list. |
| Radio Buttons | Same as dropdown but displayed as visible buttons. Better for small option sets. |
| Checkbox | A single on/off toggle. Ideal for optional add-ons (e.g. "Add gift wrapping"). |
| Checkbox Group | Multiple checkboxes. Customers can select more than one option. |
| Color Swatch | Visual color picker rendered as clickable color chips. |
| File Upload | Lets customers upload an image or file (e.g. a custom logo). |
| Date Picker | A calendar date selector. |
| Number | Numeric input with optional min/max and step controls. |
Field Configuration โ
Every field type shares a set of common settings:
Label โ
The text shown above the field on the storefront (e.g. "Custom Name"). Keep this short and descriptive.
Internal Name โ
A machine-readable identifier used in order line item properties and webhook payloads. Auto-generated from the label but can be edited. Must be unique within the template.
Keep internal names stable
If you connect VariantIQ webhooks to Zapier or Make and reference field names in your automation, changing the internal name will break those references.
Required โ
When enabled, the customer cannot add the product to cart until this field is filled in.
Options (choice-based fields) โ
For Dropdown, Radio, Checkbox Group, and Color Swatch fields, you define a list of options. Each option has:
- Label โ Displayed to the customer.
- Value โ The value stored in the order (defaults to label if not set).
- Color (Color Swatch only) โ A hex color code for the swatch chip.
You can also populate options from a Global Dataset instead of entering them manually โ useful for very large lists.
Sort Order โ
Drag the โก handle on any field to change its position. Fields are displayed top-to-bottom in the order shown in the editor.
Dynamic Pricing โ
Any option on a choice-based field can carry a price adjustment. This adds a surcharge (or discount) to the cart when the customer selects that option.
Price adjustments are stored as a separate line item from the VariantIQ Options Fee system product. The cart and checkout totals are always accurate.
Example: A "Custom Embroidery" dropdown option might have a +$5.00 price adjustment. When the customer selects it, the cart shows the base product price plus a +$5.00 (Embroidery) line.
Price adjustment limits
The Free plan supports up to 3 fields per template. Pro unlocks unlimited fields per template.
Field Limits by Plan โ
| Plan | Fields per Template |
|---|---|
| Free | 3 |
| Pro | Unlimited |
See Billing & Plans for full plan details.
