Confirmations List Page

Confirmations List Page

ListingQuick Toobar ActionsConfirmation ColumnsEditing A ConfirmationDefault Confirmation

Listing

The Confirmation list page allows you to see all the confirmations for a particular form.

As of Gravity Forms 2.4, the list of confirmations may be sorted alphabetically by clicking on the 「Name」 column header.

Hovering over the confirmation name reveals the quick toolbar confirmation actions, each of which is described below:

Quick Toobar Actions

Active/Inactive: Active sets the current confirmation to use. Inactive means the confirmation is there but it is not currently in use.Edit allows to make any modifications to your confirmations.Duplicate will make a copy of that entire confirmation.Delete permanently removes the confirmation. This cannot be undone.

Confirmation Columns

Name of your confirmation. The list may be sorted alphabetically by clicking on the column header. Type: Different types of confirmations are listed. The Text confirmation will produce text you have entered in that field. The Page type links to the WordPress related page you have specified. The Redirect will redirect you to the URL you have provided. See Confirmation Settings for more information on types. Content is the information that is included in the type you have specified. Ex: Type (redirect) Content (http://www.google.com).

Editing A Confirmation

For information on configuring a confirmation, refer to this help article.

Default Confirmation

A form needs to always process one confirmation, and therefore the Default Confirmation cannot be deleted, removed, or inactivated.

To display a custom confirmation message, you will need to edit the Default Confirmation or create a new confirmation with conditional logic enabled appropriately. The Default Confirmation will be used if the logic fails on all other confirmations.

Using Confirmation Query Strings to Populate a Form Based on Another Submission

Using Confirmation Query Strings to Populate a Form Based on Another Submission

The ChallengeHow To SolveQuick SummarySetting up the first form to send data using confirmationsSetting up the second form to receive the submitted data

The Challenge

You have two forms. The first form is used to capture general customer information, and the second is used to create a new user account on your site. Instead of creating an account with the first form using the user registration add-on, you would rather only register the user with the second form (maybe that form is used directly ions one circumstances, or the first form only creates the account under certain conditional logic criteria). In such a scenario, it is unfriendly to ask the customer to enter their information twice.

This tutorial covers a method to pass data submitted from the first form over as default values in the second.

How To Solve

The method described here uses query strings passed in the confirmation redirect, which allow you to pre-populate the second form based on the first form』s submission.

In this article, we will show you how to configure your forms and the confirmation such that data from the first form can automatically populate fields on the second form.

Want a simpler (third party) solution? For an alternative solution that is easier to setup and keeps your URL strings nice and clean, check out the third party plug-in Easy Passthrough from the folks at GravityWiz. They have a detailed 「how to」 article as well.

Quick Summary

For those that just need a quick summary, these steps may be enough. If not, review the detailed screens below.

In the first form:

Modify a confirmation of the first form to have Confirmation Type: Redirect.Enter the Redirect URL as the web page address of the second form. In the Pass Field Data via Query String field enter the query strings you wish to pass in a parameter_name=field_merge_tag format.

In the second form:

Select a field you want to receive from the first form. Check the box for 「Allow field to be populated dynamically」. Enter the query string you passed into the Parameter Name box for that field. Repeat for all passed fields.

Setting up the first form to send data using confirmations

To begin reading data from the first form, it must output the data in some way to allow the second form in the process to read from it. This is where confirmation query strings come into play. In this section, we will show you how to set up confirmation query strings to be passed from the first form to the second.

First, you will need to access your first form that will be entered by the user. In this example, we will be using a general customer information form. We will be including a Name, Email, Address, Website, and Phone field.

Next, hover over Form Settings and click on Confirmations. Select an existing confirmation, or add a new one. Most users would simply edit the default confirmation.

Once here, select the Redirect option for the Confirmation Type. This is because instead of simply displaying a confirmation message, we need to redirect data to the secondary form.

In the Redirect URL field, enter the URL of your secondary form. If you have not already created a second form, go ahead and do so as well as embed it within a page and obtain the URL for that page.The Pass Field Data via Query String field will be formatted such a way that you will have a variable containing a variable. The contents of these variables will be populated using merge tags. For example, it will look something like this: first_name={Name (First):1.3}&last_name={Name (Last):1.6} In the example above, we are creating variables for first_name and last_name, and assigning them to the corresponding submitted fields using merge tags. As we have multiple variables here, they are separated with an & symbol. To review and insert available merge tags, click the merge tag icon to the right of the field.Once all of your fields are configured to send the appropriate query strings to your secondary form, save your settings and continue on to the next steps to set up the second form that will receive the submitted data from the first.

Setting up the second form to receive the submitted data

Now that your first form is configured properly to send the submitted data via a query string, you will now need to set up the second form the receive that data and automatically populate fields from it.

Begin by accessing the second form that will receive data from the first.

Once you have done so, select a field that you would like to be automatically populated. In the screenshot below, we would like the Name field to be automatically populated.

From within your selected field, click on the Advanced tab and select the checkbox labeled Allow field to be populated dynamically. This will allow the field to become populated based on the data sent to it.

Now that dynamic population has been enabled for this field, you will simply need to map the query string variables that are sent in the first form, to be accepted and used in the second form. In the prior example that we used, the First Name field was set to the first_name query string variable. To allow the second form to accept and use this query string, simply enter first_name into the box labeled First, under Parameter Name. Of course, the exact information you will enter here will vary based on the query strings that you have created earlier.

That』s all there is to it. Any fields you configure this way will now become automatically populated based on the content you have configured them to receive from the initial form submission.

You should now have a solid understanding of how to dynamically populate a form based on another form』s submission.

Confirmation Object

Confirmation Object

IntroductionUsageProperties

Introduction
The Confirmation object contains the form confirmation settings such as confirmation text or redirect URL. It is defined as an associative array.
Usage
$form["confirmation"]["type"]; // returns the confirmation type
$form["confirmation"]["message"]; // returns the confirmation message

Properties

type string
Determines the type of confirmation to be used. Possible values: message, page, redirect

message: displays a simple message
page: redirects to a WordPress page
redirect: redirects to an exterior page

message string
Contains the confirmation message that will be displayed. Only applicable when type is set to message.

pageId string
Contains the Id of the WordPress page that the browser will be redirected to. Only applicable when type is set to page.

url string
Contains the URL that the browser will be redirected to. Only applicable when type is set to redirect.

queryString string
Contains the query string to be appended to the redirection url. Only applicable when type is set to redirect.

Configuring PayPal Standard IPN Settings

Configuring PayPal Standard IPN Settings

Notice: As of September 2016, the PayPal IPN will require SSL/HTTPS on all IPN callbacks. If you are using the PayPal IPN, you will need to obtain an SSL certificate.
When using the PayPal Payments Standard Add-On from Gravity Forms, PayPal talks to the add-on using IPN which simply lets Gravity Forms know that the payment has been processed by PayPal. In this article, we will show you how to set up your PayPal IPN to communicate with the Gravity Forms PayPal Payments Standard Add-On.

Log into your PayPal account.
To access your PayPal IPN settings, you may either:

Access the IPN settings page directly. Or:
From within your PayPal account, click on the account icon (looks like a gear) at the top right of the page, then click on Profile and Settings. Click the My selling tools menu item to the left of the page. Click on Update to the right of Instant payment notifications.

Click on the Choose IPN Settings button.
You will be prompted with a field labeled Notification URL. Enter the following, replacing example.com with the domain that the Gravity Forms PayPal Payments Standard Add-On is installed.
https://example.com/?callback=gravityformspaypal (version 3.3.1+)
https://example.com/?page=gf_paypal_ipn (version 3.3 and older)

Select the radio button labeled Receive IPN messages (Enabled).

Save your changes.

PayPal Standard IPN is now enabled. When a purchase is made, it will send a notification to the PayPal Payments Standard Add-On, letting it know that the payment was successful. If you need further information on using the PayPal Payments Standard Add-On within Gravity Forms, review our article on setting up the PayPal Payments Standard Gravity Forms Add-On.

Creating a Feed for the PayPal Payments Pro Add-On

Creating a Feed for the PayPal Payments Pro Add-On

SummaryCreate a FeedFeed Settings ScreenProducts and Services SettingsSubscription SettingsOther Settings

Summary
Before the PayPal Payments Pro Add-On can be used with Gravity Forms, you will first need to create a feed. A feed simply allows form submission data to be sent to another source. In this instance, payment data being sent to PayPal Payments Pro.
Create a Feed
To create a feed to PayPal Payments Pro using the PayPal Payments Pro Add-On for Gravity Forms, do the following from your WordPress Admin Dashboard:

Click on Forms in the left side menu.
Select the form that you want to use with PayPal Payments Pro.
Once within your desired form, hover over Settings and click on PayPal Payments Pro.
Click Add New to create a new feed. You will be presented with the PayPal Payments Pro feed settings screen.

Note: You can create multiple PayPal Payments Pro feeds for your form; however, you must configure conditional logic on them. The PayPal Payments Pro Add-On will only process one feed during submission; if conditional logic is not configured, it will use the first feed it finds.
Feed Settings Screen
The following fields are available within the settings screen. Refer to the settings screenshots below.

A feed Name is required. It is only used for identification and will not be shown anywhere other than your feed listing.
Select the Transaction Type. This will determine if you are selling a one-time or subscription-based product, and each has its own options to choose from.

Products and Services Settings
If you select Products and Services from the Transaction Type drop down, the options below will appear. If you have selected Subscription, you can skip this section as it will not apply.

Payment Amount: This drop down allows you to select the payment amount to either be a specific product field within your form or the form total.

Subscription Settings
If you select Subscription within the Transaction Type drop down, additional options that are specific to subscriptions will appear.

The Recurring Amount setting allows you to set the amount that the subscription will bill for. Using the dropdown, you can set the recurring payment amount as one of your product fields or the form total.
Pay Period determines how often the recurring payment will occur.
Recurring Times lets you set how many times the recurring payment will be made.
Enabling the Setup Fee option allows you to select a product field from your form to be used as the setup fee.

Other Settings
Under the Other Settings section, there are several other options that can be configured. These options are the same regardless of the transaction type you select.

Billing Information configures what billing information is sent to PayPal when processing a transaction. Map each of the billing fields to the desired form field that will contain that information.
Conditional Logic: If unchecked, every successful form submission will be sent to PayPal Payments Pro. If you wish to set specific conditions for sending form data to PayPal Payments Pro, then check the 「Enable Condition」 box and fill out your required criteria.
The API Settings option gives you the ability to override the default API credentials on a feed-specific basis. When doing this, the global API credentials will be ignored, and the ones within the feed will be used instead.
Click the Update Settings button to save your options.

Partial Entries Settings Reference

Partial Entries Settings Reference

Pre-RequisitesSettingsSave on ProgressWhen is a Partial Entry Saved?

The Partial Entries Add-On for Gravity Forms allows you to capture user input before the form is fully submitted. This can be quite helpful in identifying where users may be abandoning your form.

In this article, we will show you how to easily set up the capturing of partial entries on your form.

Pre-Requisites

Download and install the add-on.

Settings

Bring up the form you want to modify, and in the form editor select Settings → Partial Entries.

SettingDescriptionEnableTurn on the partial entries functionality for this form. Warning MessagePlaces an admin-defined message below the form description, making your users aware that their field values are being saved before submission.Enable Conditional LogicAllows you to set more granular conditions for when partial entry information is saved, based on completion of a specific field, or completion of a certain percentage of fields. See Save on Progress below.

Save on Progress

Partial Entries has two options under the Progress sub-heading: All Fields and Required Fields. You can set a percentage level against either of these criteria that will determine when the partial entry is saved.

In the image below, the partial entry will be saved once more than 40% of All Fields on the form have user input.

When is a Partial Entry Saved?

Partial Entries are saved depending on how often the site is ticking with the Heartbeat API, generally around every 30-60 seconds.Some hosts disable the heartbeat (like WP Engine) causing the Partial Entry to not save. Check with your site host on this.A partial entry is also saved when a page of the form is submitted (like a multipage form or a submission with a validation error) or the Save and Continue Later link is used.

Configuring Notifications in Gravity Forms

Configuring Notifications in Gravity Forms

What Is A Notification?Create a New NotificationEnter the Email SettingsMessage and SubjectDisable Auto-FormattingAdding An AttachmentUsing Conditional Logic With The Notification

What Is A Notification?

When a user submits a form, it can be quite helpful for the site administrator to receive a notification that a form has been successfully submitted. This ensures that you do not have to constantly check your Entries table to see if anything has been submitted. In this article, we will show you how to configure a basic notification for one of your forms.

Note that as your needs evolve, you can have multiple notifications for a single form, and even for a single submission. Additionally, you can determine which is activated on submission using complex conditional logic conditions. But for now, let』s just create a simple notification.

Create a New Notification

You will need to already have a form created. If you need to learn how to do so, you may review our article on creating forms.

First, access the form that you want to create a notification for. This is done by clicking on Forms on the left side navigation menu, then clicking on your desired form.At the top menu, hover over Form Settings and click on Notifications.You should now see a list of all notifications that exist for that form. By default, there should already be a single notification that sends the submissions to the admin email address within your WordPress installation. The list may be sorted alphabetically by clicking on the 「Name」 header. To add a new notification, click the Add New button.First, pick a name for your notification. This is simply something to easily identify the notification. Any unique name will be fine.

Enter the Email Settings

You will see a setting labeled Send To. This allows you to determine how the message is sent. The options available are the following: Enter Email: This is simply a single email address that all notifications for this form will be sent to.Select a Field: This option will allow you to send the notifications based on the contents of an email address field in the form.Configure Routing: This option will allow you to change the Send To email address used for the notification based on the options that the user selects in the form.For the purpose of this article, we are just going to take a look at the Enter Email option.When you have the Enter Email option selected, the Send to Email field will be available. Within this field, enter the email address that you want your form notifications to be sent to. You will need to configure a few different fields related to the email being sent. The first of these is the From Name field. When a notification email is sent, this is the name that will be displayed as the sender. Here, you can set this to something static, or dynamically generate that data. In this example, we want the name field from the form to be used as the From Name in the notification, click on the merge tag icon to the right of the field, and click on the field that you are using for the name. The number in the merge tag is the value of the field_id. Example: {text:4} will select field ID 4. {name:5.3} will target the 3rd subfield of the field ID 5. For more information on merge tags, refer to this article. Next up is the From Email field. This is the email address that is displayed as the sender when receiving the notification. You may set this to {admin_email} or use a static email address, but always use a valid from email to prevent sending and deliverability issues.There is also the Reply To field in which the reply address may be set. This can take a static email address, or use merge tags by clicking on the icon to the right of the field.The BCC field will allow you to set an email address in which the notification email will be copied to. This is useful if you have an individual that wants to receive all notification emails when sending to multiple people.

Message and Subject

The Subject and Message fields are the most important part of the notification. This is the content that lets you know the content of the form that was filled out. These default to a subject stating the form that was filled out, as well as the message containing the form content. Just like many of the previous fields, these also support merge tags to dynamically generate content. For most people, the default content is fine, but you may change this to anything you wish. Using the drop down icon next to the input boxes, you can select your form fields merge tags and also additional merge tags.

Disable Auto-Formatting

WordPress runs a function to help add paragraph spacing to your email text in order to help readability. If you』ve carefully crafted your notification layout (e.g. using HTML) and do not want any meddling from the system, select the Disable Auto Formatting checkbox below the message field.

Adding An Attachment

As of Gravity Forms 2.4, if there are File Upload fields on the form, the Attachments option displays. By selecting this option, the files that are uploaded on the form are included when the Notification is sent.

Using Conditional Logic With The Notification

Notifications support conditional logic, allowing you to define specific conditions that determine whether or not this notification gets sent. Select the option to enable conditional logic here, you can then configure your conditions. For more information on conditional logic, take a look at our article on configuring conditional logic.

Configuring Confirmations

Configuring Confirmations

Editing or Creating a ConfirmationConfirmation Settings ReferenceConfirmation Type: TextConfirmation Type: PageConfirmation Type: RedirectChanging the Default Confirmation Message

Upon submitting a form in Gravity Forms, the user will be presented with a message or directed to a new page. By default, this is a simple message letting them know that the form has been successfully submitted and thanking them for their submission. In this article, we will show you how to change your confirmation message, as well as create custom confirmation messages based on the content that is submitted.

Editing or Creating a Confirmation

If you have not yet created a form, review our article on creating forms to get started. If you have a form ready, then access the form confirmations as follows:

Access your form by clicking on Forms from the left side navigation menu, and then clicking on the title of the form that you want to modify the confirmation message for.To access the confirmations for that form, hover over Settings on the top menu, and click on Confirmations.You will see a list of available confirmations. If you want to edit an existing confirmation, click on its title. To add a new confirmation, click the Add New button. Refer to the Confirmations List Page article for more information on available actions for this page.

Animation showing how to access the Confirmations settings page for a form.

Confirmation Settings Reference

When editing a Confirmation, the following settings are available:

SettingDescriptionConfirmation NameTo help identify the confirmation in the confirmation list. Name is not displayed to the user.Confirmation TypeOptions are Text, Page, and Redirect. Se below for more information on each. MessageThis is displayed to the user upon form submission.Conditional LogicConfigure more granular conditions that must be met in order to display this confirmation. The Default Confirmation doesn』t support conditional logic. For more information on conditional logic, see this article.

Confirmation Type: Text

Text confirmations allow you to display a bit of text to the user upon submission. If you need to thank the user for their submission, this is the best and most popular option for doing so.

There』s not much to configuring a standard text notification. Select the Text option, and begin writing your confirmation message in the box below. Use the Add Media button to add an image or video. If you want to disable the auto formatting of the text, enable the checkbox labeled Disable Auto-formatting.

Confirmation Type: Page

With the Page setting within the Confirmation Type options, you will be able to set a page within your site that the user will be sent to upon submitting the form. To configure your confirmation page, use the dropdown labeled Page to select the page you want the user to be delivered to.

With a custom confirmation page option, you may also have the form data sent to the page. For example, if you want the information on the page to change based on the form information submitted, under Pass Field Data via Query String add merge tags to the box. Example:

phone={Phone:1}&email={Email:2}

Confirmation Type: Redirect

If you want the user to be redirected to another location such as an external site upon submitting the form, you may set the Redirect option. To do so, select Redirect as the Confirmation Type, and enter the full URL that you want the user to be redirected to in the Redirect URL field.

Just like the page confirmation type, you can also pass the form information via a query string in the URL. Under Pass Field Data via Query String add merge tags. Next to this field is a Merge Tag Tool {..} to make adding merge tags easier.

Changing the Default Confirmation Message

To display a custom confirmation message, you will need to edit the Default Confirmation or create a new confirmation with conditional logic enabled. The Default Confirmation will be used if the logic fails on additional confirmations. The form needs to always process one confirmation, and therefore the Default Confirmation cannot be deleted, removed, or inactivated.

Therefore, if you want to use the same confirmation for all users submitting the form, customize the Default Confirmation. If you want to show a different confirmation based on conditional logic, add as many new confirmations as you may need and configure conditional logic for them.

For more advanced information on confirmation messages, take a look at our article on confirmation message conditional logic in which you will learn how to display different confirmation messages based on conditions specified about the form content.

Configuring a Feed for the PayPal Checkout Add-On

Configuring a Feed for the PayPal Checkout Add-On

SummaryConfigure a feedFeed Settings ReferenceProducts and Services SettingsPayment AmountOther SettingsBilling InformationOptionsConditional Logic

Summary
The feed configuration determines what type of transaction should occur when the form is submitted, what to use as the payment amount, and which fields contain values that should be passed to PayPal.
If you have have added a PayPal Field to your form, you should find that a feed has already been created and configured automatically for you in the Form Settings > PayPal Checkout area. You』ll want to view this feed to ensure the Billing Information fields are mapped to the correct form fields.
Configure a feed

To configure a PayPal Checkout Feed do the following from your WordPress Admin Dashboard:

Click on Forms in the left side menu.
Select the form that you want to use with PayPal Checkout.
Once within your desired form, hover over Settings and click on PayPal Checkout.
Click Add New to create a new feed or click the Edit action link which appears when you hover over an existing feed in the table. You will then be presented with the PayPal Checkout feed settings screen.

Note: You can create multiple PayPal Checkout feeds for your form; however, you must configure conditional logic on them. The PayPal Checkout Add-On will only process one feed during submission; if conditional logic is not configured, it will use the first feed it finds.
Feed Settings Reference

The following fields are available within the settings screen.

A feed Name is required. It is only used for identification and will not be shown anywhere other than your feed listing.
Select the Transaction Type. This drop down contains the transaction types which the add-on supports. Products and Services or Subscriptions (recurring payments).

Products and Services Settings
If you select Products and Services from the Transaction Type drop down, the options below will appear.
Payment Amount

This drop down allows you to select what should be used as the payment amount. A specific product field within your form or the form total.
Other Settings
Under the Other Settings section, there are several other fields that can be configured.
Billing Information

Configures what billing information is sent to PayPal when processing a transaction. Map each of the billing fields to the desired form field that will contain that information.
Options

If you do not need PayPal to capture a shipping address, enable the checkbox labeled Do not prompt buyer to include a shipping address.
Conditional Logic

If unchecked, every successful form submission will be sent to PayPal. If you want payment to be conditional based on how the user completes the form, check the 「Enable Condition」 box and fill out the rules which must be met.

Configure Quiz Settings

Configure Quiz Settings

IntroductionHow to access the Form specific Quiz SettingsQuiz SettingsGrading SettingsPass/Fail Grading OptionsLetter Grading Options

Introduction

When you add a Quiz Field to your form, a new section will automatically be added to the Form Settings that introduces Quiz specific settings that will affect all Quiz fields on your form.

How to access the Form specific Quiz Settings

From within your form, hover over Settings and click on Quiz. This will take you to a panel of Quiz related settings.

If you do not see the Quiz settings panel, double check that you have the Quiz Add-On properly installed and that you have at least one quiz field on the form in question.

Quiz Settings

SettingDerscriptionShuffle quiz fieldsRandomize the order of the quiz fields on this form each time the form is loaded.Instant FeedbackDisplay correct or incorrect indicator (✔︎ or ) and explanation (if any) immediately after answer selection. Once an answer has been selected it can』t be changed unless the form is reloaded. This setting only applies to radio button quiz fields and it is intended for training applications and trivial quizzes. It should not be considered a secure option for critical testing requirements.

Grading Settings

By default Grading is set to None, but if you would like to add the calculation of an overall grade to your quiz, you can select either Pass/Fail or Letter grading options.

Choosing a grading type will open up an additional set of options.

Pass/Fail Grading Options

Grading OptionsDescriptionPass PercentageIdentify the percentage score the user must equal or exceed to be considered to have 「passed.」Display Quiz ConfirmationPresent the user to either a pass or fail confirmation message upon submission of the quiz form. You can specify the exact text of either message in the applicable boxes using the rich text editor.Disable Auto-formattingWordPress will sometimes automatically add paragraph spacing to your text to help readability. If you』ve carefully crafted your layout (e.g. using HTML), select the Disable Auto Formatting checkbox to disable that function.

Letter Grading Options

This option lets you assign a letter grade based on the percentage score achieved. Click the + sign to add more letter grades, and set the letter identifier and the minimum percentage for each.

Display quiz confirmation and Disable Auto-formatting are described in the table above.