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:

&#123;&#123;var product.sku&#125;&#125;
&#123;&#123;var product.name&#125;&#125;
&#123;&#123;var category.name&#125;&#125;
&#123;&#123;var customer.email&#125;&#125;
&#123;&#123;var url&#125;&#125;