🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Test Mode Setup Guide

Updated 7 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What you need
  3. Install and activate the licence
  4. Step 1: choose who can test and what a test does
  5. Step 2: test a form from the admin bar
  6. Step 3: send a test link to a client or colleague
  7. Step 4: set choices for one form
  8. Step 5: find and clean up test entries
  9. Step 6: read the test log
  10. Notifications in detail
  11. Command line
  12. Good to know

Video walkthrough

Gravity Forms Test Mode Setup Guide: Test Live Forms with TEST Entries, Test Links & Clean-up
Video setup guide: Gravity Forms Test Mode Watch on YouTube

The Gravity Forms Test Mode add-on lets you test any form on your live site without side effects. Switch test mode on from the admin bar, or send a client a private test link, and every test submission is saved as a clearly marked TEST entry: notifications go only to the tester (or are not sent at all), add-on feeds such as your CRM, mailing list, spreadsheet or webhooks are skipped, and a ribbon above the form says exactly what will happen. This guide covers installation, the settings, the admin bar switch, test links, per-form choices, test entries, the test log, clean-up and the command line tool.

What you need

You need Gravity Forms 2.9 or newer, WordPress 6.5 or newer and PHP 7.4 or newer, plus an active Gravity Forms Test Mode licence key: the test features and updates work while the licence is active. The add-on does not connect to any outside service and sends no data off your site. It works with every form, including forms that use the Gravity Forms shortcode, the block, AJAX submission and multi-page forms.

Install and activate the licence

Upload and activate the add-on like any plugin. Then go to Forms → Settings → Test Mode and enter your licence key in the Gravity Extra License panel. A Test Mode item appears in the Forms menu, every form gets a Test Mode tab in its settings, the Forms list gets a Test mode link for each form, and people with a tester role see the Form test mode switch in the admin bar. Until a valid key is active, the Test Mode screens show an activation note and no submission is treated as a test. Entries already marked as test entries keep sending their notifications only to the tester, so a resend never reaches a customer.

Step 1: choose who can test and what a test does

Open Forms → Settings → Test Mode. The settings are in three panels.

  • Who can test: tick the roles that get the admin bar switch. Only Administrator is ticked at first. Switch test mode off after sets how long a test session lasts (30 minutes to 8 hours; 2 hours by default) so nobody forgets it is on. New test links work for sets the default lifetime of a test link (1, 7 or 30 days).
  • What a test submission does: the defaults for every form. For Notifications choose Send them only to the tester (the default: every notification goes to the tester’s address with [TEST] at the start of the subject; Send To, routing, CC and BCC are replaced), Do not send any notification, or Send them as usual with [TEST] in the subject. For Feeds choose Skip add-on feeds (the default) or Run add-on feeds as usual. Mark test entries as read keeps tests out of the unread count. Show a “Test mode” ribbon shows the tester what will happen.
  • Clean up test entries: keep them (the default), move them to the Trash or delete them permanently once they are older than 1 hour, 1 day, 3 days, 7 days or 30 days. Only entries marked as test entries are ever touched.

https://gravityextra.com/wp-content/uploads/2026/10/gfxtm-settings.png

Payments are never faked. Payment add-ons always run, even for a test submission, and the ribbon reminds the tester when a form takes payments. Put your payment provider in its own test or sandbox mode when you test a paid form.

Step 2: test a form from the admin bar

Click Form test mode: Off in the admin bar. It turns orange and shows the time left, for example Form test mode: On (2 h left). Open any page with a form. Above the form you see the ribbon: TEST MODE – Your submission will be saved as a test entry. Notifications go only to you@yoursite.com. Add-on feeds are skipped. Fill in the form and submit it as a visitor would.

https://gravityextra.com/wp-content/uploads/2026/10/gfxtm-ribbon.png

The confirmation shows a second ribbon with the number of the test entry and what happened, for example Saved as test entry #214. Notifications went only to you@yoursite.com. Add-on feeds were skipped. Click the switch again to turn test mode off, or let it switch itself off. The same switch is on the Forms → Test Mode page.

People who review a form often have no account on the site. Go to Forms → Test Mode and fill in Test links:

  • Form: the form to test (in a form’s Test Mode tab this is already chosen).
  • Name (who will test): for example Client review; it appears in the entry note and the test log.
  • Send test notifications to: the address that receives every notification of these tests, usually yours or the client’s.
  • Page with the form: found automatically from the pages that show the form with the shortcode or block; you can type another page address on your site.
  • Works for: 1, 7 or 30 days.

Click Create test link and copy the address from the Link to send column. Whoever opens it submits that form as a test until the link expires or you revoke it; the secret part is removed from the address bar at once and kept in a cookie for the link’s lifetime. The link covers only its own form: other forms on the site stay real for that visitor. A changed, expired or revoked link does nothing, and the page says This test link has expired or was revoked, so submissions on this page are real. Click Revoke to stop one link, or Revoke every test link to stop all of them at once.

Step 4: set choices for one form

Open a form, go to Settings → Test Mode. Allow test submissions on this form is on by default; switch it off for a form that must always be real. Notifications of a test submission and Feeds of a test submission use the defaults from the settings unless you choose something else for this form, for example skip every notification on an event sign-up form but let its feed reach your spreadsheet. Below the settings the tab lists this form’s test links, the number of test entries with a Show them link and the Move test entries to the Trash button, and the test log of this form.

Step 5: find and clean up test entries

Every test submission is a normal Gravity Forms entry with a Test entry mark and a note such as Test submission by Maya (admin bar test mode). Each skipped feed adds a note too, for example Test entry: CRM feed “Leads” skipped. On the entries list a Test filter link shows only test entries with their count, and Test entry can be added as a column. On the entry screen a Test entry box says who tested, how, and where its notifications go.

https://gravityextra.com/wp-content/uploads/2026/10/gfxtm-entry.png

Two bulk actions on the entries list, Mark as test entry and Not a test entry, fix entries that were sent before you had the add-on or marked by mistake. To remove test entries, click Move test entries to the Trash on the Test Mode page (per form) or in the form’s tab. Gravity Forms keeps them in the Trash until you empty it, so a mistake can be undone. Automatic clean-up runs every hour when you choose it in the settings.

Step 6: read the test log

The Test log on the Test Mode page lists the latest test runs: when, which form, the entry number, who tested (admin bar or test link) and what happened to each notification (only to the tester, not sent, or sent as usual, [TEST] subject) and which feeds were skipped. It keeps the last 200 runs; Clear the test log empties it. The log never stores what was typed into the form.

https://gravityextra.com/wp-content/uploads/2026/10/gfxtm-page.png

Notifications in detail

A test entry keeps its test rules for good. Notifications that Gravity Forms sends later, such as notifications resent from the entry screen or notifications sent in the background when your site sends them after the page has loaded, follow the same rules because they are decided from the entry itself, not from the browser. The Save and Continue email of a tester goes only to the tester. The Reply To of a notification is kept, so replying to a test notification reaches the address that was typed into the form.

Command line

With WP-CLI: wp gf-test list counts test entries per form, wp gf-test purge moves test entries to the Trash (add --form=<id>, --older-than=<hours>, --permanent to delete, --yes to skip the question), wp gf-test links lists live test links without their secret part, and wp gf-test log shows the latest runs.

Good to know

  • Logged-in testers never get cached pages. With test links the submission is always a test; on a page that a cache serves as a stored copy, the ribbon may only appear after the page is loaded fresh.
  • Uninstalling the add-on removes its settings, links, log and test sessions. Entries are never deleted by uninstalling; move test entries to the Trash first if you want them gone.
  • A deleted form takes its test links and test log rows with it.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr