Viewing Quiz Results

Viewing Quiz Results

Where can I see the Quiz Results?Quiz Results DisplayResults FilterQuiz ScoringResetting Results

Where can I see the Quiz Results?

As a site administrator, you can view results from a quiz by navigating to the Form with the quiz in it, and clicking the Quiz Results link at the top of the form editor.

If you have multiple Add-Ons installed that support results, you will need to hover over the 「Results」 item and then select 「Quiz Results」.

Quiz Results Display

The quiz results are divided into a few sections within a dashboard style layout. What data you see is also dependent on which type of Quiz Grading you have enabled.

SectionDescriptionTotal EntriesQuantity of all the entries you have received for this quiz.Average ScoreAverage score as calculated across all entries received. Average PercentageAverage percentage score as calculated across all entries received.Score FrequenciesDisplays a frequency bar chart showing the spread of each quiz score. Grade FrequencyIf using letter grades, will show the frequency of each letter grade across all entries received. Individual BreakdownsThe bottom area shows each quiz field on your form, and the frequency of each answer provided.

Results Filter

The filter section displayed in the right hand sidebar allows you to limit which entries are included in your results display.

Include results if allows you filter the entries that make up your results based on other factors, such as a particular form field, or other submission metadata. For example, you could filter just those of a certain Quiz Percentage or Grade.

Start date and End date limit your results display to those submission made within a certain date range.

Quiz Scoring

Under normal scoring, a correct answer counts as 1, and an incorrect answer as 0. As such, the percentage will be the percentage of correct answers.

When using weighted scoring, you can specify different scores for each possible answer. For example, you could make one question worth 3 points for the right answer, or even make wrong answers be a negative score. This has a significant effect on scoring, especially when adding checkboxes (multiple choice) into the quiz.

Refer to our guide to Quiz Scoring for the complete rules and some detailed examples.

Caveat: Quiz results are calculated dynamically on request, As such, if you change the correct answer (or the weighted score) on a question, all past Quiz Results will be re-calculated when viewed again, which may vary from what was previously presented in the results dashboard, or to the user at the time they completed the quiz.

Resetting Results

You can learn about resetting results by reading this article.

Viewing Poll Results

Viewing Poll Results

Where can I see the Poll Results?Poll Results DisplayNoteResults FilterResetting Poll Results

Where can I see the Poll Results?

As a site administrator, you can view results from a poll by navigating to the Form with the poll in it, and clicking the Poll Results link at the top of the form editor. Poll results can be viewed either through the form builder or the Entries page.

Poll Results Display

Within this page, you will see the current results for your particular poll. In the right sidebar, you also have the ability to set filter conditions to further slice your poll data.

Poll results can be displayed to visitors of your site via the Poll Shortcode

Note

If you delete a poll field from your form the poll data will be irreversibly deleted as well.

Results Filter

The filter section displayed in the right hand sidebar allows you to limit which entries are included in your results display.

Include results if allows you filter the entries that make up your results display, based on criteria such as the content of a particular form field, or other submission metadata.

Start date and End date limit your results display to those submission made within a certain date range.

Resetting Poll Results

You can learn about resetting results by reading this article.

Video Tutorials

Video Tutorials

Three Quick Start VideosLonger Video Tutorials

Three Quick Start Videos
Click this link to see our sequence of three very short videos to quickly get you through the basics of downloading, installing, creating a form, embedding a form, and even installing and connecting a sample add-on. Don』t forget the previous/next button at the bottom of each page to cycle through them all!
After those quick intros, you can dive deeper with the Getting Started documentation category on this very site.
Longer Video Tutorials
Head over to this page on our main site for a selection of longer, topic-specific videos. They cover areas like enabling notifications and confirmations, using conditional logic, creating a survey and even collecting credit card payments with Stripe.

Verifying Your Stripe Integration

Verifying Your Stripe Integration

Pre-RequisitesVerifying Your Integration

Pre-Requisites

Set Up The Stripe Add-On
Set Up a Stripe Compatible Form
Create a Feed for the Stripe Add-On

Verifying Your Integration
Now that your Stripe Add-On is integrated with Gravity Forms, you can test this integration through the submission of forms via Gravity Forms.

Make sure you have a visible Pricing Field with a valid Price in your form. You can ensure this by selecting Forms, hovering over your form and selecting Edit. Once in Form Editor view, double check your pricing field and make sure the price field has a value. The image below is an example of what your Pricing Field might look like. Ensure you have a Field Label and a Price and click Update Form.

Next select Preview from the form editor toolbar. This will open a new tab. Fill in all of the information prior to the Credit Card field.

The Credit Card field does not require real credit card information. Instead, you will need to visit Stripe to obtain a Test Credit Card Number.

Enter a test credit card number into the Card Number box. Fill in the Expiration Date, Security Code, and Cardholder Name fields. Note that the expiration date needs to be in the future to be valid.

Submit the form.

Once you have submitted the form, visit Stripe and navigate to your Dashboard.

If you selected either Products & Services or Subscription, you will see that your transaction has gone through under Payments.

If you selected Subscription as your transaction type and don』t see funds transferred under Payments, it is most likely because you have setup a Trial period for the Subscription. You can view the date and the amount your customer will be charged by selecting Customers and then selecting the individual customer you would like more information on.

If you can see that your transaction has processed either as a payment or a pending transaction, your Stripe Add-On has been successfully integrated with Gravity Forms! If you need more information on setting up your Stripe Add-On, visit the Stripe Add-On documentation.

Validation Errors CSS Selectors

Validation Errors CSS Selectors

Validation Error MessageValidation – Error ContainerValidation – Error Description Message

Validation Error Message
Main validation error message shown at the top of the form.

example: validation error message (div) – applies to all forms
body .gform_wrapper .validation_error {border: 1px solid red}

example: validation error message (div) – applies just to form ID #1
body #gform_wrapper_1 .validation_error {border: 1px solid red}

Validation – Error Container
Individual list items containing inputs with invalid values

example: validation – error container (li) – applies to all forms
body .gform_wrapper .gform_body .gform_fields .gfield_error {border: 1px solid red}

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

Validation – Error Description Message
Description/error message below inputs with invalid values

example: validation – error description message (div) – applies to all forms
body .gform_wrapper .gform_body .gform_fields .gfield_error .validation_message {border: 1px solid red}

example: validation – error description message (div) – applies just to form ID #1
body #gform_wrapper_1 .gform_body .gform_fields .gfield_error .validation_message {border: 1px solid red}

Using the Survey Add-On

Using the Survey Add-On

IntroductionPre-RequisitesConfiguring the Survey FieldDisplay Your SurveySurvey ResultsSurvey Merge Tags

Introduction

The Survey Add-On allows you to easily interact with your users to both collect and analyze data on your target audience. Market research, customer satisfaction, employee surveys, job satisfaction surveys – anything is possible! You can even implement Survey fields on an Order Form to quickly get feedback from your customers as they place an order!

The Survey field introduces not one, but three new field types geared towards surveys: Likert, Rating, and Rank. The Survey field is accessible in the Form Editor within the Advanced Fields toolbox.

The integrated Survey Results display allows you to view your survey results and filter the results data based on your needs. You can view Survey Results for any form that contains a Survey field by clicking on the Results link on the Gravity Forms toolbar.

Pre-Requisites

Setup the Survey Add-On

Configuring the Survey Field

After installing and activating the Survey Add-On, you can now add Survey fields to your form. This is done by adding a Survey field from the Advanced Fields toolbox in the form editor to any form you would like to add a Survey to. You would add a Survey field for each survey question you would like to ask the user.

In your WordPress admin dashboard, go to New Form under the Forms navigation or edit an existing form from Forms.Add a Survey field to your form from the Advanced Fields toolbox.Edit the field and configure the options. You can configure it as a Likert, Rank, Rating, Radio Buttons, Checkboxes, Single Line Text, Paragraph Text, or Drop Down field using the Survey Field Type option.Enter the survey question in the Survey Question box.Enter the answer choices in the Choices interface based on which Survey Field Type you selected.Save your form.

That』s it! Creating a Survey using Gravity Forms is that easy.

Display Your Survey

The Gravity Forms Survey Add-On uses the standard form shortcode, function, and widget in order to display the form. You would insert your survey into a page or post using the standard methods you already use when displaying a Gravity Form on your site.

Survey Results

You can view aggregate results of your survey and filter this data based on date and field selection by going to the Survey Results. You access Survey Results by clicking on the Results navigation item in the Gravity Forms toolbar. If you have multiple Add-Ons installed that support Results, you will need to rollover the 「Results」 navigation item and then select 「Survey Results」.

Survey Merge Tags

The Survey Add-On includes a few specific merge tags for use in notifications and confirmations.

{score} — displays the score for a specific survey question.{survey_total_score} – displays the total score for the survey.

Using the Square Add-On

Using the Square Add-On

IntroductionPrerequisitesSetup SquareSetup Your FormSetting up a Square FeedViewing Sales ResultsImportant NotesSquare Add-On HooksAdd-On Framework Hooks

Gravity Forms and Square are offering a 「Free Processing Promotion」 for new Square customers that can save you credit card fees for up to 180 days. Go here for details.
Introduction
The official Gravity Forms Square Add-On allows you to quickly and easily capture one-time credit card payments with WordPress and your Square account.
Prerequisites

You will of course need Gravity Forms and the official Gravity Forms Square Add-On installed and activated.
SSL Certificate Installed and Configured
A Square account (a Square Sandbox account is also recommended, but optional)

Because of the secure nature of capturing credit card information, you will be required to install an SSL certificate on your web site if you have not already done so. You will also need to configure your WordPress site to work properly with SSL.
Contact your web host if you need assistance purchasing and configuring an SSL certificate.
If you need assistance configuring your WordPress site to work with SSL, we recommend the WordPress HTTPS (SSL) Plugin which you can find here: http://wordpress.org/extend/plugins/wordpress-https/
Setup Square
Learn how to setup the Square Add-on in our Setting Up the Square Add-on article.
Setup Your Form
Refer to the Setting up a Square Compatible Form article for detailed instructions on how to setup your form to be compatible with the Square Add-on.
Setting up a Square Feed
Now that you have configured the Square Add-on to work with your Square account, and you have a form configured, it』s time to bring it all together by configuring the form to send it』s submissions to Square. Just like all of our Gravity Forms Add-ons, this is done by creating a feed.
Review our Creating a Feed for the Square Add-on article for step-by-step instructions.
Viewing Sales Results
After creating a feed and making your first sale, you can view the results on the Sales Results page.  Review Viewing Sales Results article for more information.
Important Notes

The currency setting for your Square Account must match your Gravity Forms Currency Setting. if not matched, you will get an error when you attempt to connect to your Square account.

Square Add-On Hooks
The Square Add-On provides hooks that can be used to modify the default functionality or extend it. For more information, review the Square Add-On Hooks.
Add-On Framework Hooks
Because the Square Add-On is built using the Add-On Framework it also inherits any hooks available in the framework methods it uses such as:
gform_{$SHORT_SLUG}_field_value for changing a field value before it is passed to Square.

Using the Signature Add-On

Using the Signature Add-On

IntroductionPre-RequisitesConfiguring the Signature FieldEntry DetailsHow Does It Work?

Introduction
The Signature Add-On for Gravity Forms allows you to capture signatures online by allowing users to sign your forms using touchscreen devices, touch pads, or a mouse by adding a new field to the Advanced Fields toolbox in the Form Editor.
Quickly and easily integrate signature capabilities into your forms without the end user having to install any special browser plugins.
With the Gravity Forms Signature Add-On you can provide a very simple user interface for allowing users to sign your forms online. It captures signature information as it is drawn and sends data to your web server where this information is converted into a PNG image and stored on your server. This happens on-the-fly as soon as the user signs the field canvas.
The Signature Add-On works on all major desktop and mobile browsers. This includes IE, FireFox, Safari, Chrome, Opera, iOS, Android, Blackberry, and WebOS.
Pre-Requisites
Setup the Signature Add-On
Configuring the Signature Field
After installing the Signature Add-On you will see a new field type added to the Advanced Fields toolbox in the Form Editor when creating or editing a Gravity Form.

In your WordPress admin dashboard, go to New Form under the Forms navigation or edit an existing form from Forms.
Add a Signature field to your form from the Advanced Fields toolbox.
Edit this new Signature field and configure the field options to your liking. Under Appearance you can change the color, size, background, border, and style.
Save your form.
Capture signatures!

Entry Details
When you view the Entry Details for a Form Entry that contains a Signature field, you will see the signature included in the entry details. The signature will be presented as a thumbnail image and you can click on the thumbnail to see the full size version of the signature itself.
For security reasons it is not automatically included as part of the {all_fields} merge tag output. You can include signatures in your email notifications by inserting the merge tag for your Signature field in the message of your notification.
How Does It Work?
The Gravity Forms Signature Add-On is powered by the well established signature capture software SuperSignature. The SuperSignature technology and source code has been licensed by rocketgenius, inc. for redistribution as an official Gravity Forms Add-On.

Using the reCAPTCHA Add-On

Using the reCAPTCHA Add-On

IntroductionPre-RequisitesSetupBehaviorReviewing Spam EntriesNotesMore info

Introduction

The official Gravity Forms reCAPTCHA Add-On brings Google』s reCAPTCHA v3 technology as an addition to your anti-spam toolbox.

V3 was introduced to try and capitalize on the evolving technology of spam and bot detection that Google had implemented, and to try and make the reCAPTCHA experience as frictionless as possible by not interrupting the user. As stated by Google, reCAPTCHA v3:

…return(s) a score to tell you how suspicious an interaction is and eliminating the need to interrupt users with challenges at all. reCAPTCHA v3 runs adaptive risk analysis in the background to alert you of suspicious traffic while letting your human users enjoy a frictionless experience on your site. Google Blog post, October 2018

Pre-Requisites

This add-on requires Gravity Forms 2.5 or higher. You will need reCAPTCHA v3 keys generated by Google. reCAPTCHA technology requires Javascript to be enabled in the user』s browser. 

Setup

Instructions for setup are covered in this article.

The reCAPTCHA v2 settings previously provided in Gravity Forms core are consolidated into this settings area as well.

Behavior

With reCAPTCHA v3 correctly enabled on the site with valid keys, various actions are noted and sent to Google for them to try and identify possible spam or bot activity. This processing is done on Google』s servers, and the result is the assignment of a score to the activity. reCAPTCHA v3 returns a score, where 1.0 is very likely a good interaction, 0.0 is very likely a bot.

Note that all well-formed entries are accepted when submitted, and the Google reCAPTCHA score that is generated with that interaction is stored with the entry. Gravity Forms will compare that score to the threshold established in your settings, and if the entry is less than or equal to that threshold, the entry will be sent to spam.

When using reCAPTCHA v3, you no longer need to add a reCAPTCHA field to your form (that field applies to v2 implementations only). The v3 integration ensures that it is automatically enabled on all forms unless it is disabled in the form settings of an individual form.

Reviewing Spam Entries

You can review entries that were marked as spam by following the directions provided in this article.

Notes

Does not affect older reCAPTCHA functionality as previously provided in Gravity Forms. Both can exist on the same page if necessary.Works with multi-page forms. reCAPTCHA does not process submissions submitted from the form preview.Use of this Google service requires the sending of user behavior information from all your site pages to Google for evaluation. You should be familiar with the implications here, and review applicable privacy policy and terms and conditions. Additionally, you are required to display those policies to your users, which is handled with the reCAPTCHA badge.

More info

Google』s developer documentationGoogle』s reCAPTCHA FAQ

Using the Polls Add-On

Using the Polls Add-On

Pre-RequisitesIntroductionSetup Your Poll FormAdding a Poll to your SiteDisplaying Your Poll Results

Pre-Requisites

Setting up the Polls the Add-On

Introduction

The Gravity Forms Polls Add-On allows you to quickly and easily deploy Polls on your website using the power of Gravity Forms. The Polls Add-On allows you to add fields to your form that ask users questions, capture their response, and show them the results of the poll when the form is submitted.

Polls are a great way to interact with your users and receive instant feedback. With the Gravity Forms Polls Add-On you are not limited to just a single poll question. You can add as many Poll Fields to your form as you』d like.

Setup Your Poll Form

This article reviews setting up a Poll Form in the Form Editor.

Adding a Poll to your Site

There are a few different ways you can add your already-configured poll to your page or post.

using a shortcodeusing a Poll Block, chosen from within WordPress block editor. See this article.using a Poll Widget to insert the poll into your sidebar in site themes that support it. Refer to this WordPress page on widgets.

This article provides an in-depth example of adding a poll to your WordPress website.

Additionally, you can use the Poll specific merge tags to display poll fields or results, or just a standard Gravity Form block and choose a poll form.

Due to the way they are implemented, each presentation option may not offer the full suite of settings. For most use cases, the Poll Block is the best option, as it has a full suite of controls and a variety of display options. See the article linked below for some more details.

Displaying Your Poll Results

You have a few options on how you display poll results to site visitors and poll submitters, depending on the method you used to insert the poll on your page. Refer to the article Displaying your poll results to visitors for details.