NEX-Forms Documentation

Documentation & Tutorials for NEX-Forms version 8.0 and above

Docs » Email Notifications Setup » Using Smart Data Tags in Emails

Using Smart Data Tags in Emails

This article will guide you on how to use Smart Data Tags in your emails.

In this Article

How to add a Smart Data Tag to your Email Body
How to add a Smart Data Tag to your Email Attributes
Field option VALUE vs LABEL Data Tags
- Using the Option VALUE Data Tag
- Using the Option LABEL Data Tag
System Default Data Tags List
Logged in User Data Tags List
PayPal Data Tags List

How to add a Smart Data Tag to your Email Body

This section will guide you on adding any Smart Data Tag to your Email Body.

TAKE NOTE:
For the purpose of this exercise we will assume that the form we are creating this email for is a simple contact form consisting of a Name, Email and Query field.

Open your form's Email Editor.
Click or stay in Visual Mode
Click on the "+ Add Field Tag" button and all available data tags will show up on the left hand side of the editor.
All available data tags will appear on the left hand side of the editor.
Place your mouse cursor inside the email body where you need the data tag to be inserted.
Click on any data tag (in this example we are clicking on a field data tag called "Name")
The field data tag will automaticaly be generated where your cursor was placed inside the message text.

How to add a Smart Data Tag to your Email Attributes

This section will guide you on adding Smart Data Tags to your Email Attributes like, for example, Recipients Email Addresses.

TAKE NOTE:
For the purpose of this exercise we will assume that the form we are creating this email for is a simple contact form consisting of a Name, Email and Query field.

Open your form's Email Editor.
RIGHT CLICK in any of the Email attribute Fields. In the below Example we will RIGHT CLICK in the Reply-To Email Attribute.
The Field data tags Context Menu will now popup.
Click on the Field Data Tag. In the Emxample we will insert the Email Field's Data Tag.
The field data tag will automaticaly be generated where you RIGHT CLICKED.

Field option VALUE vs LABEL Data Tags

This section will guide you on how to use a selection field's option values and/or labels.

TAKE NOTE:
For the purpose of this exercise we will assume that we have a radio field called "Product" with the following options:
100==Single Page Website
120==Database Setup
350==Website Revamp

IMPORTANT: When using selections field with different values to the option labels its VALUE==LABEL.

Using the Option VALUE Data Tag (Default)

Open your form's Email Editor.
Click or stay in Visual Mode
Click on the "+ Add Field Tag" button.
Click on Product under the Field Tags section.
The generated tag for outputing the field's option VALUE have now been generated at the location of your cursor inside the message.

OUTPUT:
In this example the {{product}} field data tag will output any of the following based on the user's selection:
100
120
350

Using the Option LABEL Data Tag (Default)

Open your form's Email Editor.
Click or stay in Visual Mode
Click on the "+ Add Field Tag" button.
Click on Product under the Field Tags section.
The generated tag for outputing the field's option VALUE have now been generated at the location of your cursor inside the message.
PREFIX the field data tag with real_val__ so you end up with {{real_val__product}}

OUTPUT:
In this example the {{real_val__product}} field data tag will output any of the following based on the user's selection:
Single Page Website
Database Setup
Website Revamp

System Default Data Tags List

Find a list below of all available System Data Tags to be used in Email Bodies and any Email Attributes.

System Default Data Tag Definitions
Tag Name	Data Tag	Output
Form Data Table	{{nf_form_data}}	Outputs all the submitted form data in table format. (for use in Message Body Only)
Page Title	{{nf_page_title}}	Ouputs the title of the page from where the form was submitted
Page ID	{{nf_page_id}}	Ouputs the ID of the page from where the form was submitted
Page URL	{{nf_from_page}}	Ouputs the URL of the page from where the form was submitted
Form Title	{{nf_form_title}}	Ouputs the title of the form that was submitted
Form ID	{{nf_form_id}}	Ouputs the ID of the Form that was submitted
Entry ID	{{nf_entry_id}}	Ouputs an unique generated Form Entry ID. This can be used as a reference or order number, etc.
Date and Time	{{nf_entry_date_time}}	Ouputs the date and time when the form was submitted
Date	{{nf_entry_date}}	Ouputs the date when the form was submitted
Date - Day	{{nf_entry_date_day}}	Ouputs the day when the form was submitted
Date - Month	{{nf_entry_date_month}}	Ouputs the month when the form was submitted
Date - Year	{{nf_entry_date_year}}	Ouputs the year when the form was submitted
Time	{{nf_entry_time}}	Ouputs the time when the form was submitted
User IP Address	{{nf_user_ip}}	Ouputs the IP address of the user who submitted the form.

Logged-in User Data Tags List

Find a list below of all available logged-in User Data Tags to be used in Email Bodies and any Email Attributes.

Logged-in User Data Tag Definitions
Tag Name	Data Tag	Output
Username	{{nf_user_name}}	Outputs the registered username of the user that submitted the form while logged in.
User First Name	{{nf_user_first_name}}	Outputs the registered first name of the user that submitted the form while logged in.
User Last Name	{{nf_user_last_name}}	Outputs the registered last name of the user that submitted the form while logged in.
User Email Address	{{nf_user_email_address}}	Outputs the registered email address of the user that submitted the form while logged in.
User URL	{{nf_user_url}}	Outputs the registered URL of the user that submitted the form while logged in.

PayPal Data Tags

Find a list below of all available PayPal Data Tags to be used in Email Bodies and any Email Attributes.

PayPal Data Tag Definitions
Tag Name	Data Tag	Output
PayPal Data Table	{{nf_paypal_data}}	Outputs all the PayPal data sent back from PayPal in table format. (For use in Email Message only).
Payment Status	{{nf_paypal_status}}	Outputs the status of the payment - Paid, Unpaid or Pending.
Payment Ammount	{{nf_paypal_ammount}}	Outputs the amount that was paid.
Payment Currency	{{nf_paypal_currency}}	Outputs the currency in which the payment was paid.
Transaction ID	{{nf_paypal_payment_id}}	Outputs an unique ID of the payment transaction.
Transaction Token	{{nf_paypal_payment_token}}	Outputs an unique ID of the payment transaction.

Was this article helpful?

Yes

Still having trouble? How can we help you?

This article was last updated on 19 November 2024

Popular Articles

Stay in Touch

Get the latest NEX-Forms news and info by following us on:

In this article

NEX-Forms Documentation

YEAR END SPECIAL NOW ON!