Entry moderation Merge Tags

To enable users to moderate entries from emailed notifications, you can use entry moderation Merge Tags, added in GravityView 2.17. The Merge Tags are replaced in the notification emails with links to approve, disapprove, or reset approval of an entry.

Merge Tags

  • {gv_approve_entry} Link to approve an entry
  • {gv_disapprove_entry} Link to disapprove an entry
  • {gv_unapprove_entry} Link to unapprove an entry (reset approval)


  • :[\d+d|h|m|s] Number followed by unit (d day, h hour, m minute, s second) of hours the approval link is valid for. 24h by default.
  • :public Make the link clickable by anyone, even users who are logged-out. (Requires the "Enable Public Entry Moderation" GravityView setting or per-form setting to be enabled).

Example usage

  • {gv_approve_entry} - Valid for default (24 hours). Private.
  • {gv_approve_entry:48h} - Valid for 48 hours. Private.
  • {gv_approve_entry:20m} - valid for 10 minutes. Private.
  • {gv_approve_entry:public} - Valid for default (24 hours), public
  • {gv_approve_entry:2h:public} - valid for 2 hours, public
  • {gv_approve_entry:20m:public} - valid for 20 minutes, public

The same usage pattern applies for {gv_disapprove_entry} and {gv_unapprove_entry} Merge Tags.


For these Merge Tags to work, the "Enable Public Entry Moderation" option must be activated on GravityKit's Settings page > GravityView tab:

Screenshot showing GravityKit's Settings page


Tokens are in JWT format. The secret used to generate the token is wp_salt('auth').

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us