The Form Editor

The Form Editor

OverviewTop BarThe Field LibraryThe Layout Space

Overview

The Form Editor is where most of your design and layout effort for your will be spent. Our editor layout is designed with a similar look and feel to the Block Editor in WordPress, so it should be pretty intuitive. But if this is your first steps with WordPress, or you are transitioning from a different form editor, then below you can find a quick overview of each of the areas of the form editor screen.

Top Bar

The top horizontal bar of the Gravity Forms Form Editor offers the following options:

Shows you the form you are editing, and allows you to quickly switch to other forms.Go to Form Settings.Go to this form』s Entries list.Show a preview off this form.Update the form and capture the changes you have made.

The Field Library

The right hand side of the Form Editor screen is where you can find the library of all available fields that can be added to your form.

The search bar allows you to quickly find any field.Two tabs are offered to this section, Here the Add Fields tab is selected, which shows all the available field categories.This tab gives you access to the field settings of the selected field, and will auto-select when you are select a field.All the available fields are shown here, grouped under multiple field type categories. Choose the category you are interested in, and it will expand to reveal all the available field of that category.

The following categories of fields are usually available here:

Standard Fields: the simple basics.Advanced Fields: multi-part and more complex fields.Post Fields: fields associated with WordPress posts, such as tags and excerpts.Pricing Fields: product related fields.More field categories may be added here by other add-ons.

The Layout Space

The main area of the Form Editor screen is where you arrange and tweak your fields. Drag and drop any field you like from the library onto the layout space. Here you can change settings, set the layout order, and even create columns.

Here is a quick animation to show you how fast your form can be pulled together.

< previous article next article: Fields >

Form Data

Form Data

IntroductionUsagePropertiesLine ItemHooks

Introduction
Form Data ($form_data) is an associative array containing the payment related properties for the entry being processed by the Authorize.Net add-on which extends the GFPaymentAddOn class. It is populated using the values from the Submission Data Object generated during form validation.
Usage
We recommend accessing the properties in $form_data using the rgar() function, e.g.:
1$form_data = rgar( $submission_data, 'payment_amount' );

Properties

form_title string
The form title.

email string
The value of the field which was mapped to the billing information Email field.

address1 string
The value of the field which was mapped to the billing information Address field.

address2 string
The value of the field which was mapped to the billing information Address 2 field.

city string
The value of the field which was mapped to the billing information City field.

state string
The value of the field which was mapped to the billing information State field.

zip string
The value of the field which was mapped to the billing information Zip field.

country string
The value of the field which was mapped to the billing information Country field.

first_name string
The Credit Card cardholder first name.

last_name string
The Credit Card cardholder last name.

amount float
Either the form total or the value of the field mapped to the feeds payment amount or recurring amount setting.

fee_amount integer
Zero or the value of the field mapped to the setup fee setting.

line_items array
An indexed array of line items with unit prices greater than or equal to zero. Created from the submitted pricing fields. See Line Item for available properties.

Line Item
12345678array(    'item_id'          => 1,    'item_name'        => 'Product A',    'item_description' => '',    'item_quantity'    => '1',    'item_unit_price'  => 10,    'item_taxable'     => 'Y',)
Each line item is an associative array containing the following properties.

item_id integer
The field ID.

item_name string
The product name or shipping name.

item_description string
Comma separated string of selected option names.

item_quantity integer
The quantity.

item_unit_price float
The total unit price for the product and any selected options or the shipping price.

item_taxable string
Is the line item taxable? Default is Y.

Hooks
The Form Data can be modified by using the gform_authorizenet_form_data filter.

Form Confirmation CSS Selectors

Form Confirmation CSS Selectors

Inline Confirmation Message

Inline Confirmation Message
Displays on same page upon successful completion of the form

example: inline confirmation message (div) – applies to all forms
body .gform_confirmation_wrapper .gform_confirmation_message {border: 1px solid red;}

example: inline confirmation message (div) – applies to form id 1
body #gform_confirmation_wrapper_1 .gform_confirmation_message {color: black;}

Form Body CSS Selectors

Form Body CSS Selectors

ContainerField ListContainerList ItemsField InputsInput ContainerDescription ContainerRequired Field Indicator (Asterisk)

Container
Contains the main form content

example: the form body section (div) – applies to all forms
1body .gform_wrapper .gform_body  {border: 1px solid red}

example: the form body section (div) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body {border: 1px solid red}

Field List
Container
unordered list used to structure all of the form elements

example: the form list container (ul) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields {border: 1px solid red}

example: the form list container (ul) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields {border: 1px solid red}

List Items
Individual list items containing each form element

example: the form list item (li) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield {border: 1px solid red}

example: the form list item (li) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield {border: 1px solid red}

Field Inputs
Input Container
Wraps the actual form element inside the containing list item

example: input field container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .ginput_container {border: 1px solid red}

example: input field container (div) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .ginput_container {border: 1px solid red}

example: input field container (div) – applies just to specific form field (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields  #field_XX_X.gfield .ginput_container {border: 1px solid red}

Description Container
Contains the field description inside the containing list item

example: input field description container (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_description {border: 1px solid red}

example: input field description container (div) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_description {border: 1px solid red}

example: input field description container (div) – applies just to specific field description (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields  #field_XX_X.gfield .gfield_description {border: 1px solid red}

Required Field Indicator (Asterisk)

example: required field indicator (span) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gfield .gfield_label .gfield_required {color: red}

example: required field indicator (span) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gfield .gfield_label .gfield_required {color: red}

example: required field indicator (span) – applies just to specific indicator (based on the unique parent element ID – replace 「XX_X」 with your actual element ID)
1body .gform_wrapper .gform_body .gform_fields  #field_XX_X.gfield .gfield_label .gfield_required {color: red}

Forcing Gravity Forms Database Upgrades

Forcing Gravity Forms Database Upgrades

If you』re having issues upgrading the Gravity Forms database after an update, this can sometimes be due to a failed database modification. Often times, forcing the database upgrade can resolve the issue. Attempting to do a manual upgrade is not recommended and this method should be followed. Here』s how to force a Gravity Forms database upgrade.

Before making any changes, it』s always a good idea to backup your database. If you』re not sure how to do so, contact your web hosting provider.Within your WordPress admin dashboard, hover over Forms and click on System Status.Scroll down to the Database section and click on Re-run database upgrade.

Your database upgrade should now be complete.

If you are getting repeated upgrade issues, contact our support team for expert technical advice.

The System Status page, showing the database upgrade option.

Finding Your Gravity Forms Account

Finding Your Gravity Forms Account

IntroductionFinding A Gravity Forms AccountI think I remember the account email…I have no clue as to what the account email might be…I used an agency or contractor to setup my website, and they never gave me the license

Introduction

Sometimes you may find you have a Gravity Forms license key in use on your site, but do not know or cannot remember exactly which Gravity Forms account that owns it. This stops you from logging in and performing account management operations like updating a payment method, as well as some license operations such as reviewing your site list or canceling an auto-renewal.

There are a couple of approaches you can use to try and find out the Gravity Forms account.

Finding A Gravity Forms Account

The approach to finding an account depends on what information you have.

IMPORTANT NOTE: we can not always identify a third party owner to you due to our privacy policies related to customer data.

Using a Gravity Forms license key on your website does not mean you have a right to the Gravity Forms account that holds that license key. The account owner is defined as the owner of the email address the account is held under, and identifying information can only be provided to that validated user in most circumstances.

I think I remember the account email…

If you have a few commonly used email addresses for sign-ups, then try using the Password Reset functionality on our Gravity Forms account page to see if the account exists.

You can request a password reset email here: https://www.gravityforms.com/wp-login.php?action=lostpassword

Don』t forget to check your Bulk or Spam folders. Password Reset emails often trigger spam checks and result in your legitimate request being dumped into an unseen Bulk or Suspicious folder by your email service.

Once you have reset the password and logged in you』ll be able to view your profile, licenses, and access the downloads here: https://www.gravityforms.com/my-account/

I have no clue as to what the account email might be…

You may have inherited the website with Gravity Forms installed from a previous employee, design agency or third party. This might mean that you have no idea what email address the account is held under.

We can search for your license key using some key data, and then identify the holding account.

To try and locate the owning account, reach out to the General Questions support channel for assistance, and provide some of the following information.

If you know the license only from the website it is on:

Provide the URL of the website where you think the license is in use

If you know the license key number:

Provide the license key to us.

If you know only the charge on your credit card, the provide us the following transaction details:

Payment method details (e.g. PayPal account email or last 4 digits of credit card used) Date of the transaction. Amount of the transactionFull Name on the Credit or Debit Card

From there we can try to find the account by working backwards from the transaction.

I used an agency or contractor to setup my website, and they never gave me the license

If you know the license is owned by a third party, then you will have to reach out to them directly. Only the account owner can perform certain operations, such as requesting technical support, or transferring the license to you.

If you have no recollection of who you used, or no method to contact the site developer you think probably holds the license key, then we recommend you purchase a new license and register it on your site. This can be done without any disruption to your forms or form data, and is the only way to guarantee you have full control over your key moving forward.

You can purchase on our website. Be sure to obtain the license type that has access to all the add-ons and meets the site count you require. For a quick comparison of license types, see this help guide.

File Upload

File Upload

SummaryCommon SettingsGeneral SettingsNotesMerge TagsUsageModifiers

Summary

The File Upload field allows users to upload a file with their form submission. You may limit which filetypes a user may upload via the properties tab. It is available under the Advanced Fields section within the form editor.

File Upload field as displayed in the Field Library

File Upload field as displayed in the Form editor

Common Settings

This field uses only common field settings for the Appearance and Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find description of specialty settings that are particular to this field.

General Settings

SettingsDescriptionAllowed file extensionsEnter the allowed file extensions for file uploads. This will limit what type of files a user may upload. See note 1.Enable Multi-File UploadIf checked, this option allows the user to upload multiple files. If unchecked (default state), the upload will accept only a single file. See note 2.Maximum File SizeUse this to specify the maximum size in megabytes allowed for each of the files.

Notes

1. See this article for important notes on WordPress permitted file types.2. Once an entry has been submitted using this field, this option will no longer be editable. That is, you cannot switch a file upload field from from single file to multi-file once an entry with a file has been submitted.

Merge Tags

For more information on the use of merge tags, refer to these articles.

Usage

{Field Name:2:modifier}

Modifiers

ModifiersDescription:downloadDenotes that the link created for the download should force the download when accessed.