Skip to main content

Field Types

Text

text

Text input field. Field value(s) parameter accepts following variables:

{{email}} - customer e-mail address

{{firstname}} - first name of the customer

{{lastname}} - last name of the customer

{{company}} - customer's billing profile company

{{city}} - customer's billing profile city

{{street}} - customer's billing profile street

{{country_id}} - customer's billing profile country 2 symbol code

{{region}} - customer's billing profile region

{{postcode}} - customer's billing profile postcode

{{telephone}} - customer's billing profile telephone

{{fax}} - customer's billing profile fax

Variables are applied only when customer is logged in.

Text / E-mail

Text input field with e-mail validation. This field is used as a reply-to for admin e-mail notifications if customer is not logged in. Text field variables are supported.

Text / Number

Text input field with number validation. If input value contains symbols different from digits an error message will be generated. Text field variables are supported.

Text / URL

Text input field with URL validation. Text field variables are supported.

Textarea

textarea

Textarea input field. Text field variables are supported.

HTML Editor

editor

Rich text editor field with formatting abilities.

Newsletter Subscription / Checkbox

subscribe

If checked, subscribes customer to Magento Newsletter. E-mail field is required in the form. You can set custom text in Field value(s) parameter.

To check field by default set custom text beginning with ^. For example:

^I would like to receive store updates be e-mail

Select

Select input field. Options should be stored in Field value(s) parameter separated be new line. Text field variables are supported.

Example:

Option 1
Option 2
Option 3

Default values should start with ^. Example:

Option 1
Option 2
^Option 3

This will select Option 3 by default.

--Please select-- type options should start with ^^. Example:

^^--Please select--
Option 1
Option 2
Option 3

Separate Labels And Values

If you need to set separate value from the label use {{val ...}} construction. Example:

One {{val 1}}
Two {{val 2}}
Three {{val 3}}

Select / Radio

radio

Select field presented as a group of radios. Field value(s) follows the same format as Select field.

Select / Checkbox

checkbox

Select field presented as a group of checkboxes allowing multiple selection. Field value(s) follows the same format as Select field.

Adding images to Select / Radio and Select / Checkbox

select images

Add images to select fields from media folder with the code:

Option {{img myfolder/myfile.png}}

Upload images to your media folder using your FTP client (such as WinSCP).

select images upload

Then put correct codes near select field values like on the screenshot.

select_images_backend

Select / Contact

Select input field. Options should be stored in Field value(s) parameter separated be new line and follow the format:

Name 1 <mailbox1@mysite.com>
Name 2 <mailbox2@mysite.com>
Name 2 <mailbox3@mysite.com>

Contact field lets you redirect notification to the desired mailbox depending on customer selection.

You can use it as subject field to mail inquiry to the responsible person in your company or use it as departments selection.

Select / Country

Select country input. Result object stores country code.

Date

date

Date input field with date picker.

Date / Time

Date and time input field with date picker with time selection added.

Star Rating

star rating

Rating input field. Field value(s) parameter defines how many stars to show and default rating value.

Image Upload

File upload input field with pre-defined popular image extensions to accept. In notification letters and results grid image thumbnails are rendered with the link to file location on server.

Html Block

Html text block in the form. Field value(s) parameter stores html source for the block. This field is excluded from results.

Hidden

Hidden fields are used to store information not visible to the user.

Since version 2.7.8 hidden fields accepts variables instead of PHP code:

{{var product.sku}}
{{var product.name}}
{{var category.name}}
{{var customer.email}}
{{var url}}