0 items
Sign in
Buy

Docs

Merge tags added by GravityBoard

Estimated reading: 1 minutes

Updated on April 23, 2026

GravityBoard provides custom merge tags for use in Gravity Forms notifications, confirmation messages, and anywhere else Gravity Forms merge tags are supported. Merge tags are dynamic placeholders that automatically populate form data (like user info, field values, or entry details).

Voting merge tags #

The following merge tags provide vote data for the current entry:

  • {gravityboard_votes:count} — Total number of voters on the entry.
  • {gravityboard_votes:average} — Average vote weight across all voters (rounded to 2 decimal places).
  • {gravityboard_votes:total} — Net vote total (sum of all weights). Can be negative if downvotes outnumber upvotes.
  • {gravityboard_votes:up} — Number of upvotes (voters with positive weight).
  • {gravityboard_votes:down} — Number of downvotes (voters with negative weight).

Voter email merge tag:

  • {voters_emails} — Comma-separated list of email addresses of all users who voted on the entry.

Assignee merge tags #

General assignee merge tags:

  • {gravityboard_assignees:emails} – Comma-separated list of assignee email addresses.
  • {gravityboard_assignees:names} – Comma-separated list of assignee display names.
  • {gravityboard_assignees:list} – Formatted list of assignees with avatars (HTML in HTML context, plain text otherwise).

The following merge tags are specific to the individual assigned user:

  • {gravityboard_assignee_email} – The email address of the assignee. Also available as {gravityboard_assignee:user_email} .
  • {gravityboard_assignee:display_name} – The display name of the assignee.
  • {gravityboard_assignee:user_login} – The login name of the assignee.
  • {gravityboard_assignee:first_name} – The first name of the assignee.
  • {gravityboard_assignee:last_name} – The last name of the assignee.
  • {gravityboard_assignee:ID} – The WordPress user ID of the assignee.

See this article on the Gravity Forms {user} Merge Tag for usage.

Mention notification merge tags #

The following merge tags are available specifically for the “Mention Notification Subject” and “Mention Notification Body” inputs in the GravityBoard Notification settings.

  • {notifier_name} – The display name of the user who wrote the note and mentioned someone.
  • {mentioned_user_name} – The display name of the user who was mentioned.
  • {note_excerpt} – A short excerpt of the note containing the mention.
  • {entry_details_url} – A URL to view the entry details within Gravity Forms (your site’s backend).
  • {board_name} – The name of the GravityBoard.
  • {entry_id} – The ID of the Gravity Forms entry.
  • {form_id} – The ID of the Gravity Form.
  • {site_title} – The title of your WordPress site.
  • {admin_email} – The admin email address for your WordPress site.

Using email merge tags in notifications

The email-related merge tags are particularly useful in Gravity Forms notification settings. Here’s an example:

  1. Navigate to Forms → Your Form → Settings → Notifications
  2. Create a new notification or edit an existing one
  3. In the “Send To” field, you can use:
    • {gravityboard_assignees:emails} – Sends to all card assignees

You can also use these merge tags in the CC and BCC fields to include additional recipients.

Was this page helpful?

Table Of Contents