Section Break CSS Selectors

Section Break CSS Selectors

ContainerTitleDescription

Container
Wraps the section break elements inside the containing list item

example: section break container (li) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gsection {border: 1px solid red}

example: section break container (li) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gsection {border: 1px solid red}

example: section break container (li) – applies just to specific section break container (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.gsection {border: 1px solid red}

Title

example: section break title (h2) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gsection .gsection_title {color: red}

example: section break container (li) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gsection .gsection_title {color: red}

example: section break container (li) – applies just to specific section break title (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.gsection .gsection_title {color: red}

Description

example: section break description (div) – applies to all forms
1body .gform_wrapper .gform_body .gform_fields .gsection .gsection_description {border: 1px solid red}

example: section break description (li) – applies just to form ID #1
1body #gform_wrapper_1 .gform_body .gform_fields .gsection .gsection_description {border: 1px solid red}

example: section break description (li) – applies just to specific section break 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.gsection .gsection_description {border: 1px solid red}

{score} Merge Tag

{score} Merge Tag

SummaryUsageModifiersNotes

Summary

Displays the score for a specific survey question. Scoring must be enabled on the survey field for it to be tallied.

Usage

{score:id=x}

Modifiers

:id

The ID of the specific survey question

Notes

Quiz and Survey related merge tags can only be used in confirmations and notifications.For more information, Refer to our Survey Add-On documentation.

Save and Continue

Save and Continue

SummaryHow Save and Continue WorksEnabling Save and ContinueConfirmations/NotificationsMerge Tags{save_email_input}{save_email}{save_link}{save_url}{save_token}Save and Continue Link Recovery

Summary

Save and Continue functionality is a critical feature that many individuals rely on when building large forms. By utilizing Save and Continue functionality, users are able to save their place and come back to the form without the need to start over again. In this article, we will show you how to use the Save and Continue functionality within Gravity Forms.

How Save and Continue Works

The Save and Continue functionality within Gravity Forms will create a link for continuing the form at a later date. Upon clicking the link in the form, the user will be presented with a custom link to the current state of their form submission, with the option of sending the link via email.

Links created will last 30 days. After that period, the link will no longer be accessible. To override this, you can utilize the gform_incomplete_submissions_expiration_days filter.

Note: If you are handling sensitive data, be sure that you have SSL (HTTPS) enabled and running on your site. The URL generated is accessible to anyone who has it, and the URL can be used to decrypt the saved details within the database. Without encryption, it』s possible that someone could access the partially submitted data as well as continue the submission of it.

Note: Single File Upload fields will not preserve any file added prior to the Save and Continue action. This is because single file fields are not validated as non-malicious until form submission is submitted. Thus when Save and Continue is used, any single file uploads attempted will be cleared and not preserved by the link. This behavior does not exist with Multi-File Upload fields, as they validate uploaded files at the time of upload, not form submission.

Note: When using a List field, the column names must be unique or the data will not save when using Save and Continue.

Enabling Save and Continue

First, access the form that will utilize the Save and Continue functionality. This can be done by clicking on Forms on the left side of your WordPress admin, then clicking on the form that you want to enable Save and Continue on. Next, access the form settings for the form by clicking on Settings at the top of the form editor. Within the form settings page, you should see an option labeled Save and Continue. Simply enable the checkbox to allow Save and Continue functionality within the form. Upon enabling Save and Continue, an additional field will be available to change the link text. If you would like to change the text content of the Save and Continue link, you can enter your new text here.

Of course, don』t forget to save your settings when complete.

Confirmations/Notifications

Upon enabling the Save and Continue option, additional confirmations and notifications are created. To change any notifications or confirmations related to the Save and Continue link, access the new items as you normally would with other notifications or confirmations.

Save and Continue Confirmations

Save and Continue Notifications

Due to the Save and Continue feature using its own confirmations and notifications that are independent of any existing items, you will need to modify these independently. Also note that if you disable the Save and Continue feature, the notifications and confirmations that were automatically created will be deleted.

Merge Tags

{save_email_input}

Outputs the input field that is used for sending the continue link to an address. A custom validation message, as well as button text can be passed.

Example

{save_email_input: button_text="Send the link to my email address" validation_message="The link couldn't be sent because the email address is not valid."}

{save_email}

The email address that the saved partial input has been sent to.

{save_link}

This outputs the Save and Continue link as a clickable link. For use as part of the content for the default Save and Continue Confirmations and Save and Continue Email only.

{save_url}

This outputs the Save and Continue URL only. For use as part of the content for the default Save and Continue Confirmations and Save and Continue Email only.

{save_token}

The token generated.

Save and Continue Link Recovery

Save and Continue links are stored in a separate database table, so they are not accessible from anywhere in the WordPress admin dashboard. If you have the Partial Entries add-on installed and enabled, links can be recovered using the partial entries listing.

Save Button

Save Button

IntroductionExample

Introduction
The save type field, part of the Settings API, renders a submit type input.
Example
The following example renders a section with a text input and a save button with custom error and success messages.
1234567891011121314151617array(    'title'  => esc_html__( 'This is the title for Section 1', 'sometextdomain' ),    'fields' => array(        array(            'type'  => 'text',            'name'  => 'mytextfield',            'label' => esc_html__( 'This is my text field', 'sometextdomain' ),        ),        array(            'type'     => 'save',            'messages' => array(                'error'   => esc_html__( 'Settings could not be updated.', 'sometextdomain' ),                'success' => esc_html__( 'Settings have been updated.', 'sometextdomain' ),            ),        ),    ),),
The code above will render a layout similar to the following:

Save and Continue Link CSS Selectors

Save and Continue Link CSS Selectors

ContainerAdditional InfoExamples

Container
The Save and Continue link is contained within the form footer.
Additional Info
For more information on the Save and Continue functionality, refer to the Save And Continue user guide article.
Examples

example: the form Save and Continue link – applies to all forms
body .gform_wrapper .gform_footer a.gform_save_link {border: 1px solid red}

example: the form Save and Continue link – applies just to form ID #1
body #gform_wrapper_1 .gform_footer a.gform_save_link {border: 1px solid red}

example: the form Save and Continue link – applies just to form ID #1 and save link in the first page of a multipage form
body #gform_wrapper_1 .gform_footer a#gform_save_1_2_link {border: 1px solid red}

{save_email_input} Merge Tag

{save_email_input} Merge Tag

DescriptionUsageParametersExample

Description
The {save_email_input} merge tag in Gravity Forms will insert a form into the 「Save and Continue」 confirmation allowing the user to enter an email address the resume link should be sent to.
Usage
1{save_email_input: button_text="Custom button text" placeholder="Custom placeholder" validation_message="Custom validation message"}

Parameters

button_text string
Custom text to display within the button.

placeholder string
Custom placeholder to display within the email input.

validation_message string
Custom validation message to display if the submission is invalid.

Example
1{save_email_input: button_text="Send the link to my email address" placeholder="Please enter your email" validation_message="The link couldn't be sent because the email address is not valid."}

Role and Capability Management

Role and Capability Management

Gravity Forms CapabilitiesAdd-On Capabilities2CheckoutActiveCampaignAdvanced Post CreationAgile CRMAkismetAuthorize.NetAWeberBreezeCampaign MonitorCampfireCapsule CRMChained SelectsCleverReachConstant ContactCouponsDropboxEmmaFreshbooksGetResponseHelp ScoutHighriseHubSpotiContactMad MimiMailchimpMailgunMolliePartial EntriesPayPal CheckoutPayPal StandardPayPal Payments ProPayPal ProPipePollsPostmarkQuizreCAPTCHASlackSendGridSquareStripeSurveyTrelloTwilioUser RegistrationWebhooksZapierZoho CRM

Gravity Forms introduces new capabilities to the WordPress Role system. These capabilities are only manageable via a plugin that makes use of the WordPress Role Management system.

We recommend using the Members plugin for role management.

The User Role Editor plugin can also be used but does not list the capabilities unless they have already been granted to at least one user or role.

Gravity Forms consists of the following capabilities that can be controlled via role management.

Gravity Forms Capabilities

CapabilityLabelgravityforms_create_formCreate Formsgravityforms_delete_formsDelete Formsgravityforms_edit_formsEdit Formsgravityforms_preview_formsPreview Formsgravityforms_view_entriesView Entriesgravityforms_edit_entriesEdit Entriesgravityforms_delete_entriesDelete Entriesgravityforms_view_entry_notesView Entry Notesgravityforms_edit_entry_notesEdit Entry Notesgravityforms_export_entriesImport/Exportgravityforms_view_settingsView Plugin Settingsgravityforms_edit_settingsEdit Plugin Settingsgravityforms_view_updatesManage Updatesgravityforms_view_addonsManage Add-Onsgravityforms_system_statusView System Statusgravityforms_uninstallUninstall Gravity Formsgravityforms_loggingLogging Settingsgravityforms_api_settingsREST API Settings

Add-On Capabilities

2Checkout

CapabilityLabelgravityforms_2checkout2Checkout: Add-On Settingsgravityforms_2checkout_uninstall2Checkout: Uninstall

ActiveCampaign

CapabilityLabelgravityforms_activecampaignActiveCampaign: Add-On Settingsgravityforms_activecampaign_uninstallActiveCampaign: Uninstall

Advanced Post Creation

CapabilityLabelgravityforms_advancedpostcreationPost Creation: Add-On Settingsgravityforms_advancedpostcreation_uninstallPost Creation: Uninstall

Agile CRM

CapabilityLabelgravityforms_agilecrmAgile CRM: Add-On Settingsgravityforms_agilecrm_uninstallAgile CRM: Uninstall

Akismet

CapabilityLabelgravityforms_akismetAkismet: Add-On Settingsgravityforms_akismet_uninstallAkismet: Uninstall

Authorize.Net

CapabilityLabelgravityforms_authorizenetAuthorize.Net: Add-On Settingsgravityforms_authorizenet_uninstallAuthorize.Net: Uninstallgravityforms_authorizenet_plugin_pageAuthorize.Net: Add-On Page

AWeber

CapabilityLabelgravityforms_aweberAWeber: Add-On Settingsgravityforms_aweber_uninstallAWeber: Uninstall

Breeze

CapabilityLabelgravityforms_breezeBreeze: Add-On Settingsgravityforms_breeze_uninstallBreeze: Uninstall

Campaign Monitor

CapabilityLabelgravityforms_campaignmonitorCampaign Monitor: Add-On Settingsgravityforms_campaignmonitor_uninstallCampaign Monitor: Uninstall

Campfire

CapabilityLabelgravityforms_campfireCampfire: Add-On Settingsgravityforms_campfire_uninstallCampfire: Uninstall

Capsule CRM

CapabilityLabelgravityforms_capsulecrmCapsule CRM: Add-On Settingsgravityforms_capsulecrm_uninstallCapsule CRM: Uninstall

Chained Selects

CapabilityLabelgravityforms_chainedselectsChained Selects: Add-On Settingsgravityforms_chainedselects_uninstallChained Selects: Uninstall

CleverReach

CapabilityLabelgravityforms_cleverreachCleverReach: Add-On Settingsgravityforms_cleverreach_uninstallCleverReach: Uninstall

Constant Contact

CapabilityLabelgravityforms_constantcontactConstant Contact: Add-On Settingsgravityforms_constantcontact_uninstallConstant Contact: Uninstall

Coupons

CapabilityLabelgravityforms_couponsCoupons: Add-On Settingsgravityforms_coupons_uninstallCoupons: Uninstallgravityforms_coupons_plugin_pageCoupons: Add-On Page

Dropbox

CapabilityLabelgravityforms_dropboxDropbox: Add-On Settingsgravityforms_dropbox_uninstallDropbox: Uninstall

Emma

CapabilityLabelgravityforms_emmaEmma: Add-On Settingsgravityforms_emma_uninstallEmma: Uninstall

Freshbooks

CapabilityLabelgravityforms_freshbooksFreshbooks: Add-On Settingsgravityforms_freshbooks_uninstallFreshbooks: Uninstall

GetResponse

CapabilityLabelgravityforms_getresponseGetResponse: Add-On Settingsgravityforms_getresponse_uninstallGetResponse: Uninstall

Help Scout

CapabilityLabelgravityforms_helpscoutHelp Scout: Add-On Settingsgravityforms_helpscout_uninstallHelp Scout: Uninstall

Highrise

CapabilityLabelgravityforms_highriseHighrise: Add-On Settingsgravityforms_highrise_uninstallHighrise: Uninstall

HubSpot

CapabilityLabelgravityforms_hubspotHubSpot: Add-On Settingsgravityforms_hubspot_uninstallHubSpot: Uninstall

iContact

CapabilityLabelgravityforms_icontactiContact: Add-On Settingsgravityforms_icontact_uninstalliContact: Uninstall

Mad Mimi

CapabilityLabelgravityforms_madmimiMad Mimi: Add-On Settingsgravityforms_madmimi_uninstallMad Mimi: Uninstall

Mailchimp

CapabilityLabelgravityforms_mailchimpMailChimp: Add-On Settingsgravityforms_mailchimp_uninstallMailChimp: Uninstall

Mailgun

CapabilityLabelgravityforms_mailgunMailgun: Add-On Settingsgravityforms_mailgun_uninstallMailgun: Uninstall

Mollie

CapabilityLabelgravityforms_mollieMollie: Add-On Settingsgravityforms_mollie_uninstallMollie: Uninstall

Partial Entries

CapabilityLabelgravityformspartialentries_form_settingsPartial Entries: Form Settingsgravityformspartialentries_uninstallPartial Entries: Uninstallgravityformspartialentries_settingsPartial Entries: Add-On Settings

PayPal Checkout

CapabilityLabelgravityforms_ppcpPayPal Checkout: Add-On Settingsgravityforms_ppcp_uninstallPayPal Checkout: Uninstall

PayPal Standard

CapabilityLabelgravityforms_paypalPayPal: Add-On Settingsgravityforms_paypal_uninstallPayPal: Uninstall

PayPal Payments Pro

CapabilityLabelgravityforms_paypalpaymentsproPayPal Payments Pro: Add-On Settingsgravityforms_paypalpaymentspro_uninstallPayPal Payments Pro: Uninstall

PayPal Pro

CapabilityLabelgravityforms_paypalproPayPal Pro: Add-On Settingsgravityforms_paypalpro_uninstallPayPal Pro: Uninstall

Pipe

CapabilityLabelgravityforms_pipePipe: Add-On Settingsgravityforms_pipe_uninstallPipe: Uninstall

Polls

CapabilityLabelgravityforms_polls_form_settingsPolls: Form Settingsgravityforms_polls_uninstallPolls: Uninstallgravityforms_polls_settingsPolls: Add-On Settingsgravityforms_polls_resultsPolls: Poll Results

Postmark

CapabilityLabelgravityforms_postmarkPostmark: Add-On Settingsgravityforms_postmark_uninstallPostmark: Uninstall

Quiz

CapabilityLabelgravityforms_quiz_form_settingsQuiz: Form Settingsgravityforms_campfire_uninstallQuiz: Uninstallgravityforms_quiz_settingsQuiz: Add-On Settingsgravityforms_quiz_resultsQuiz: Quiz Results

reCAPTCHA

CapabilityLabelgravityforms_recaptchareCAPTCHA: Add-On Settingsgravityforms_recaptcha_uninstallreCAPTCHA: Uninstall

Slack

CapabilityLabelgravityforms_slackSlack: Add-On Settingsgravityforms_slack_uninstallSlack: Uninstall

SendGrid

CapabilityLabelgravityforms_sendgridSendGrid: Add-On Settingsgravityforms_sendgrid_uninstallSendGrid: Uninstall

Square

CapabilityLabelgravityforms_squareSquare: Add-On Settingsgravityforms_square_uninstallSquare: Uninstall

Stripe

CapabilityLabelgravityforms_stripeStripe: Add-On Settingsgravityforms_stripe_uninstallStripe: Uninstall

Survey

CapabilityLabelgravityforms_surveySurvey: Add-On Settingsgravityforms_survey_uninstallSurvey: Uninstallgravityforms_survey_resultsSurvey: Survey Results

Trello

CapabilityLabelgravityforms_trelloTrello: Add-On Settingsgravityforms_trello_uninstallTrello: Uninstall

Twilio

CapabilityLabelgravityforms_twilioTwilio: Add-On Settingsgravityforms_twilio_uninstallTwilio: Uninstall

User Registration

CapabilityLabelgravityforms_user_registrationUser Registration: Add-On Settingsgravityforms_user_registration_uninstallUser Registration: Uninstallpromote_users or gravityforms_user_registrationUser Registration: Add-On Settings (Pending Activations page)

Webhooks

CapabilityLabelgravityforms_webhooksWebhooks: Add-On Settingsgravityforms_webhooks_uninstallWebhooks: Uninstall

Zapier

CapabilityLabelgravityforms_zapierZapier: Add-On Settingsgravityforms_zapier_uninstallZapier: Uninstall

Zoho CRM

CapabilityLabelgravityforms_zohocrmZoho CRM: Add-On Settingsgravityforms_zohocrm_uninstallZoho CRM: Uninstall

rgpost()

rgpost()

DescriptionUsageParametersExamples1. Single Input Field Type2. Multi-input Field TypeSource Code

Description
Access an input value from a POST request.
Usage
1rgpost( $name, $do_stripslashes );

Parameters

$name string
The input name that you want to access in the POST request.

$do_stripslashes boolean
Indicates if the stripslashes_deep() function should be applied to the retrieved value before it is returned. Defaults to true

Examples
1. Single Input Field Type
This example shows how you can access the value from a single input field.
1$value = rgpost( 'input_1', true );
2. Multi-input Field Type
This example shows how you can access the value from a specific input in a multi-input type field. In this example we are accessing the value from input 3 of field 1.
1$value = rgpost( 'input_1_3' );
Source Code
This function is located in gravityforms.php

rgobj()

rgobj()

DescriptionUsageParametersExamplesSource Code

Description
Gets a method within an object.
Usage
1rgobj( $obj, $name );
Parameters

$obj object
The object that you want to access.

$name string
The method within the object that you want to access.

Examples
1234// Returns the return value of _object->method_.$obj = 'object';$name = 'method';rgobj( $obj, $name );
Source Code
This function is located in forms_model.php

rgget()

rgget()

DescriptionUsageParametersExamples

Description
Obtains GET variables from the URL.
Usage
1rgget( $name, $array );
Parameters

$name string
The query string key that you want to get.

$array array
An array containing variables. Defaults to all GET variables.

Examples
12// Gets the current form ID on the Edit page.$form_id = rgget( 'id' );