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

Gravity Forms Site Feedback Button & Page Screenshot Setup Guide

Updated 13 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What you need
  3. Install and activate
  4. Quick start in four steps
  5. Button settings
  6. Which pages and which visitors
  7. The panel
  8. The Page Screenshot field
  9. Privacy: what is hidden and what is stored
  10. Page details sent with every message
  11. After submission: entry, column, merge tags and notification
  12. Security, limits and spam
  13. How it differs from other GravityExtra add-ons
  14. Frequently asked questions
  15. Does the screenshot show exactly what the visitor sees?
  16. Is the whole page captured, or only the visible part?
  17. Can visitors send feedback without a screenshot?
  18. Where are the screenshots stored, and are they deleted with the entry?
  19. Can I use the field without the floating button?
  20. Does it slow my pages down?
  21. What happens when my license expires?
  22. Changelog

Video walkthrough

Gravity Forms Site Feedback Button Setup Guide: Page Screenshots, Markup & Bug Reports
Video setup guide: Gravity Forms Site Feedback Button Watch on YouTube

The Gravity Forms Site Feedback Button & Page Screenshot add-on adds a Feedback button to your website. When a visitor clicks it, one of your Gravity Forms forms slides in from the side of the screen with a screenshot of the page they are looking at already attached. They can draw a box around the problem, point at it with an arrow, drop numbered pins on the picture and blur anything private before they send it. With every message you also receive the page address and title, the size of the visitor’s screen, their browser and system, who was logged in, how far down the page they had scrolled and the last JavaScript errors on that page. It is built for agencies collecting client feedback on a site in progress, for site owners who want clear bug reports, and for teams who review their own pages before a launch. This guide covers installation, the button settings, the Page Screenshot field, privacy, what your team receives and the questions people ask most.

An account page with the feedback panel open on the right: the message field, and a screenshot of the page where the plan box is blurred, a red box and arrow mark the heading, a numbered pin sits on the page and the password and gift card fields are covered
The feedback panel: the screenshot is taken when the panel opens and the visitor marks it up before sending.

What you need

  • WordPress 6.5 or newer and PHP 7.4 or newer.
  • Gravity Forms 2.9 or newer (tested with 2.9 and 3.1).
  • A GravityExtra license key for this add-on.
  • A form for the feedback. The add-on can create one for you.

Nothing else is needed: no outside service and no account anywhere else. The screenshot is drawn in the visitor’s browser by a small library that ships with the add-on and is loaded from your own site, and everything is stored on your own server with your other Gravity Forms uploads.

Install and activate

  1. In WordPress go to Plugins → Add New → Upload Plugin, choose the add-on zip file and click Install Now, then Activate.
  2. Go to Forms → Settings → Site Feedback, paste your license key and click Activate License.
  3. The page now shows the button, page and visitor settings. Every feature of the add-on needs an active license: without one there is no button, the Page Screenshot field shows nothing and no screenshots are stored.

Quick start in four steps

  1. On Forms → Settings → Site Feedback click Create a ready-made feedback form. The add-on adds a form called “Site feedback” with a message box, the Page Screenshot field, a name field, an email field and a team notification, and selects it as the form in the panel.
  2. Choose a button label, a colour, an icon and a position.
  3. Under Where and for whom choose the pages and the visitors that see the button. For a client review keep it to logged-in users or one role.
  4. Turn on Show the Feedback button and click Save Settings. Open your site in another browser window and click the button.

Prefer your own form? Add the Page Screenshot field from the Advanced Fields group of the form editor to any form and choose that form in the settings.

Button settings

The Site Feedback settings: Show the Feedback button turned on, the form in the panel, the button label, panel title, position, button colour and icon, with the Create a ready-made feedback form button
Button settings under Forms → Settings → Site Feedback.

Show the Feedback button turns the button on or off for the whole site without losing your settings.

Form in the panel is the form that opens. Forms without a Page Screenshot field are marked in the list: they still open in the panel, but no screenshot and no page details are attached.

Button label and Panel title are the words on the button and at the top of the panel, for example “Feedback” and “Send us your feedback”, or “Report a problem” and “Tell us what went wrong”.

Position puts the button in the bottom right or bottom left corner, or as a tab on the middle of the right or left edge of the screen. The panel slides in from the same side.

Button colour is a hex colour such as #1d4ed8. The text colour is chosen automatically for good contrast, white on dark colours and near-black on light ones.

Icon is a speech bubble, a bug, a megaphone, a camera or no icon.

Which pages and which visitors

Pages has three choices. All pages shows the button everywhere on the front of the site. Only these pages shows it only on the paths you list. All pages except these hides it on the paths you list, for example your checkout.

Write one path per line. /pricing/ matches the pricing page, with or without the closing slash. A star matches the rest of a path: /shop/* matches every page under the shop. A single / is the home page. You can paste full addresses; the add-on keeps only the path and ignores query strings.

Visitors decides who sees the button: everyone, logged-in users, users with these roles (tick the roles below) or site administrators only. A common set-up for an agency is a “Client” or Editor role that sees the button while the public does not. The rule is also checked on the server: a message sent from the panel by someone who is not allowed to see it is refused. The button never appears on admin screens.

If a page already shows the feedback form itself, for example a Contact page with the form on it, the panel is left out on that page so the form is not shown twice.

The panel

The panel is a dialog that slides in from the side. It works with the keyboard: the button can be reached with Tab and opened with Enter or Space, focus moves to the first field of the form, Tab and Shift+Tab stay inside the panel while it is open, and Escape or the close button closes it and puts the focus back on the button. Screen readers announce it as a dialog with its title. The form inside is an ordinary Gravity Forms form sent with AJAX, so validation messages and the confirmation appear in the panel without leaving the page. On a phone the panel fills the screen.

The feedback panel on a phone: it fills the screen with the message field and the screenshot of the account page, with the password field covered
On a phone the panel fills the screen; the screenshot shows what the visitor saw.

The Page Screenshot field

When the panel opens, the field takes a screenshot of the part of the page the visitor can see, at the current scroll position, without the panel itself. You can switch this off under Screenshot and privacy → Take the screenshot automatically when the panel opens; the visitor then clicks Take a screenshot of this page. When the field is used in a form placed directly on a page, the visitor always takes the screenshot with that button.

Once the screenshot is there, the visitor can mark it up with the tool buttons above the picture:

  • Box: drag to draw a red frame around something.
  • Arrow: drag from where the arrow starts to what it points at.
  • Pin: click to drop a numbered pin. Pins are numbered in order, so the message can say “pin 1 is the wrong price, pin 2 is the broken link”.
  • Blur: drag over an area to blur it, for example an order number or a name. The blur is part of the picture that is sent: the original pixels are not kept.
  • Undo removes the last mark, Retake takes a new screenshot and Remove sends the message without one.

The field follows the usual field settings: label, description, required, custom validation message, CSS class, admin label and conditional logic. Make it required if every message must include a picture.

When a screenshot cannot be taken. Some pages cannot be drawn in the browser, for example when a browser extension blocks scripts or the page is very unusual. The visitor then sees a clear message with three choices: Try again, Upload a screenshot from their device (PNG, JPEG or WebP; it is turned into a PNG and can be marked up the same way) or simply send the message without a screenshot. The entry notes that the screenshot could not be taken.

Privacy: what is hidden and what is stored

The screenshot is taken in the visitor’s browser and only sent when they submit the form, so they see exactly what you will receive. Before the picture is drawn, the add-on hides sensitive fields:

  • Password fields are always covered with a dark block marked “Hidden”, and their contents are cleared in the copy of the page that is drawn.
  • Card fields (fields whose browser autocomplete says they hold card details) and one-time code fields are covered the same way.
  • Any element with the CSS class gesf-mask or the attribute data-gesf-mask is covered. Add the class to a Gravity Forms field under Appearance → Custom CSS Class to hide that field.
  • Under Also hide these elements you can add your own CSS selectors, one per line, such as .account-balance or #order-history.
  • Embedded frames (maps, videos, payment boxes and any other iframe) are never drawn. A grey placeholder marked “Embedded content not captured” takes their place, so content from other websites never ends up in your screenshots.

The visitor can blur anything else before sending. Please mention in your privacy policy that the feedback form attaches a screenshot of the page and technical details, and that visitors can blur or remove the screenshot before sending.

Query strings are removed. Links often carry tokens, for example a password-reset link or a link from an email campaign. By default the add-on removes the part of every captured address after ? or #: in the page address, in the source of each JavaScript error and in addresses mentioned inside error messages. If you need campaign parameters for your reports, tick Keep query strings and #fragments in captured URLs.

Page details sent with every message

Together with the screenshot the field sends the page details in a hidden input. They are cleaned on the server (unknown details are dropped, lengths are limited) and saved with the entry:

  • the page address and the page title;
  • the viewport size, the device pixel ratio and the screen size;
  • the browser and system, for example “Chrome 130 on macOS” or “Safari 18 on iOS”;
  • the logged-in user and their role, read on the server (never taken from the browser), or “Not logged in”;
  • the scroll position when the screenshot was taken;
  • the visitor’s language and time zone;
  • the last 10 JavaScript errors of the page, with the file, line and column where they happened;
  • the time the message was sent.

The JavaScript error log starts in the head of the page, before your other scripts, so errors thrown while the page loads are included. It only runs on pages that show the button or a form with the Page Screenshot field.

After submission: entry, column, merge tags and notification

The Page feedback box on an entry: page address, page title, viewport, browser, user, scroll position, time, a JavaScript error with its file and line, and the marked-up screenshot
The Page feedback box on the entry screen.

The screenshot is stored as a PNG in the Gravity Forms uploads folder of the form, under a long random file name, and the Page Screenshot field of the entry holds its address. Click it on the entry screen to open it full size.

Entries list. Forms with the field get a Feedback page column showing the page path and a thumbnail of the screenshot, so you can scan new feedback at a glance. The field column also shows a thumbnail. Use Select Columns on the entries list to add or move them.

Entry screen. The Page feedback box lists the page, title, viewport, browser, user, scroll position, time and JavaScript errors, with the screenshot underneath.

Merge tags for notifications and confirmations:

  • {feedback:url} – the page address
  • {feedback:title} – the page title
  • {feedback:screenshot} – the screenshot: a picture in HTML emails, its address in plain text
  • {feedback:browser} – browser and system
  • {feedback:viewport} – viewport, pixel ratio and screen size
  • {feedback:user} – the logged-in user and role
  • {feedback:errors} – the JavaScript errors, one per line
  • {feedback:time} – when the message was sent

The tags appear in the merge tag list of forms that contain the field. They never clash with the Gravity Forms field tags such as {Your message:1}, because those always end in a field number. The field’s own tag returns the screenshot too.

Team notification. The ready-made form comes with a notification called “Team: new site feedback” sent to the site admin email address, with the page title in the subject and the message, page, sender, browser, errors and screenshot in the body. Change the address under Settings → Notifications, or add the merge tags to your own notifications, for example one per project manager or a routing rule per page.

Security, limits and spam

  • Checked on the server. The upload must be a real PNG image. The add-on checks the file signature and every block of the file, refuses anything else (SVG, HTML, broken files, a different image type with a PNG label), and refuses images larger than the size limit or 4096 × 4096 pixels.
  • Cleaned before it is stored. Only the image data is kept: text blocks, camera data, colour profiles and anything after the end of the image are removed, and when the GD image library is available on your server (it is on almost every host) the picture is written again from its pixels.
  • Size limit. Screenshot size limit (MB) defaults to 4 MB. The browser reduces large screenshots to fit before sending.
  • Rate limit. Messages per visitor and In minutes (5 per 10 minutes by default) limit how many feedback messages one IP address can send. Further messages are refused with a friendly note to try again later. Enter 0 to turn the limit off. Gravity Forms spam protection (honeypot, reCAPTCHA and similar) works as usual on the form.
  • Random file names mean a screenshot address cannot be guessed from another one.
  • No outside connection. The add-on makes no outside HTTP request beyond the GravityExtra licence and update checks, and the screenshot library is loaded from your own site only when a screenshot is taken.

How it differs from other GravityExtra add-ons

Our Screen Recording add-on records a video of a screen the visitor chooses to share. Image Annotation lets people draw on an image they upload. Popups open forms on triggers such as time on page or exit intent. Site Feedback is the one that captures the current page as an image, with the page and browser details and the JavaScript errors, from a button that you control by page and by role. Gravity Forms itself has no screenshot field.

Frequently asked questions

Does the screenshot show exactly what the visitor sees?

It is a faithful drawing of the page made in the browser, at the visitor’s screen size and scroll position. Most pages look the same; a few effects (some filters, canvas animations, videos and embedded frames) can differ or are left out. Images from other websites are left out unless that website allows it.

Is the whole page captured, or only the visible part?

The visible part, at the current scroll position. That is what the visitor is talking about, and it keeps files small. The scroll position is saved so your team can find the spot.

Can visitors send feedback without a screenshot?

Yes, unless you make the field required. They can click Remove before sending.

Where are the screenshots stored, and are they deleted with the entry?

In the Gravity Forms uploads folder of the form, like other uploaded files. Deleting the entry follows your Gravity Forms settings for uploaded files. Uninstalling the add-on removes its settings but keeps your entries and their screenshots.

Can I use the field without the floating button?

Yes. Put a form with the Page Screenshot field on any page; the visitor clicks Take a screenshot of this page. The page details and errors are sent the same way.

Does it slow my pages down?

The button, panel script and style are small. The screenshot library is only downloaded when a screenshot is taken, and only on pages that show the button or the field.

What happens when my license expires?

The button disappears, the field shows nothing, no new screenshots are stored and the merge tags return nothing. Entries and screenshots you already have stay where they are.

Changelog

1.0.0 (October 31, 2026) — Initial release: floating Feedback button with label, colour, icon, position, page rules and visitor rules; accessible slide-in panel with an AJAX form; Page Screenshot field with boxes, arrows, numbered pins, blur, retake and an upload fallback; password, card and marked fields covered and embedded frames never captured; page details with the last 10 JavaScript errors and query strings removed by default; server checks and cleaning of every screenshot, random file names and a rate limit; Feedback page column, Page feedback box, {feedback:…} merge tags and a ready-made form with a team notification.

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