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

Gravity Forms Points & Rewards Premium Add-on Setup Guide

Updated 10 min read Gravity Forms Integrations A–Z
On this page
  1. Video walkthrough
  2. What You Get
  3. How It Differs From the Free GamiPress Integration
  4. Requirements
  5. Install and Activate
  6. Add a Points Feed
  7. Awarding and Deducting Points
  8. Awarding an Achievement or Setting a Rank
  9. Who Gets the Reward
  10. Once for Every Entry
  11. Gate a Form by Points or Rank
  12. Merge Tags and Prefill
  13. For Developers
  14. Limits to Know
  15. Frequently Asked Questions
  16. Do I need a paid GamiPress add-on?
  17. Can I use it with the free GamiPress Gravity Forms integration?
  18. Can a visitor give points to someone else?
  19. What happens when the amount field is empty or not a number?
  20. Does it send data outside my site?

Video walkthrough

Gravity Forms GamiPress: Award Points, Ranks and Rewards from Form Entries
Gravity Forms entries award GamiPress points and ranks Watch on YouTube

Points and Rewards joins Gravity Forms and the free GamiPress plugin. A feed on your form gives points, takes points, awards an achievement or sets a rank, once for every entry. Merge tags and prefill show a member their own balance, and a gate can hide a form or block it until the member has enough points or a high enough rank. Use it for a loyalty club, a points shop, a course community, a member feedback bonus or a reward for finishing a profile.

A Gravity Forms form that shows a logged-in member their GamiPress balance: 95 coins, 18 experience points, the rank Silver and 1 badge, filled in by merge tags
A form can show the member their own balance, rank and badge count.

What You Get

  • A feed with five actions: Award GamiPress points, Deduct GamiPress points, Award a GamiPress achievement, Set a GamiPress rank and Hide or block the form unless the user has enough points or a rank.
  • Points that are a fixed number, or the answer of a number, calculation, quantity or total field, with a multiplier and a cap for each entry.
  • Any GamiPress points type, for example coins and experience points, in separate feeds of the same form.
  • Every move goes through the public GamiPress functions, so the GamiPress log, its points based achievements and its hooks work as for any other award.
  • Once for every entry: resending a notification, editing the entry or running the feeds again never rewards a second time.
  • The logged-in user is rewarded, with no account needed. As an option, a visitor can be matched or created by email, with the same safety rules as our other add-ons.
  • Merge tags and prefill for the balance, rank and badge count of the member.
  • Conditional logic, delayed payment support, entry notes, and a clear notice when GamiPress is missing or too old.

How It Differs From the Free GamiPress Integration

GamiPress has a free integration for Gravity Forms on wordpress.org. It adds events such as submitting a form, submitting a specific form or submitting a field value, and you build the reward inside GamiPress as a step of an achievement. That is a good fit for a fixed reward that follows a rule you describe in GamiPress. Points and Rewards works from the other side: the form says what happens. The amount can come from the entry, the reward can be a deduction or a rank, a feed can have conditions, and a gate can protect the form. The two can live together on one site.

Requirements

  • WordPress 6.5 or newer and PHP 7.4 or newer.
  • Gravity Forms 2.9 or newer.
  • The free GamiPress plugin, version 2.0 or newer. This version was tested with GamiPress 8.0.8.
  • A GravityExtra license key.

Install and Activate

  1. Install and activate Gravity Forms and the free GamiPress plugin if they are not active yet.
  2. Create at least one points type in GamiPress (GamiPress, Points Types). Create achievements and ranks too if you want to award them.
  3. Upload and activate the Gravity Forms Points & Rewards Premium Add-on.
  4. Go to Forms → Settings → Points & Rewards, enter your license key and press Activate.

If GamiPress is missing, too old or switched off, a notice on the Forms screens says so. Your forms keep working and the entries are saved, but nobody is rewarded and no gate is applied.

Add a Points Feed

Open Form Settings → Points & Rewards, press Add New, choose an action and fill in the sections that appear.

The Points and Rewards feed settings in Gravity Forms: the action, who gets the reward, the points type, an amount taken from a form field with a multiplier and a cap, and the log text
One feed: what to give, to whom, and how much, taken from a field if you like.
Setting What it does
Action Award points, deduct points, award an achievement, set a rank, or gate the form. The sections of the page change with the action.
User The logged-in user (the default): a visitor gets nothing and the entry note says so. Or the logged-in user, and for a visitor the account of the email in the form.
Points type One of your GamiPress points types.
Amount A fixed amount, or the answer of a form field. The answer is read as a number: 40, 1,250.50 or a product choice that holds a price all work. Anything else moves nothing and the entry gets an error note.
Multiplier The answer is multiplied by it and rounded down. 0.5 gives one point for every two units, 10 gives ten points for each unit.
Largest amount per entry A cap. One entry never moves more than this, whatever a field holds. There is also a hard limit of 1,000,000 points for one feed and one entry.
When the balance is too low For a deduction: take nothing and write an error note, or take what the user has down to zero.
Log text The text shown in the GamiPress log. Form merge tags work, and so do the GamiPress tags for the user, the points and the points type. Empty uses the GamiPress text.
Once per user Reward each user only once with this feed, however many entries they send.
Condition Run the feed only when the conditional logic you set is met.

Awarding and Deducting Points

Points are awarded with the GamiPress function that every GamiPress add-on uses, so the move appears in the GamiPress log as points earned or deducted, and GamiPress checks its points based achievements right after. The balance is read before and after, and the entry note tells the real change: for example Awarded 25 Coins to user 14 with GamiPress: balance 0, now 25.

A deduction never lets a balance fall below zero, which is how GamiPress works. With the setting Deduct nothing and write an error note, a user who has 20 coins and is asked to pay 30 loses nothing and the entry says why. Use that for a redeem form: the entry shows the failure and you can handle it. With Deduct what the user has the balance goes to zero.

Awarding an Achievement or Setting a Rank

Pick an achievement from the list of your published achievements, grouped by achievement type. The add-on awards it with the GamiPress award function, which records the earning and runs the GamiPress hooks. A user who already has it is told so in the entry note and nothing is awarded again. A draft achievement is never awarded.

For a rank, pick a published rank. With the option Promotion only, which is on by default, the rank is set only when it is higher than the one the user has, so a form can never lower a member. Turn it off if a form should be able to move a member to any rank, for example a form that resets a season.

Who Gets the Reward

The default is the logged-in user. No account is created or changed. A visitor gets nothing, and the entry note says that the visitor was not logged in.

For a public form such as a contest, choose the second option. A visitor then gets the account of the email in the form. The add-on is careful here, because a form is open to everyone.

  • An email that already has an account is refused by default. With the setting set to reward that account, the account only gets the reward: its name, password, role and everything else stay as they are.
  • An account that can manage the site or users is never rewarded from an email address, even if you allow existing accounts.
  • A new account gets the WordPress default role, or another role from the list. Roles that can manage users or the site, write posts, upload files or manage GamiPress are never in the list, even if a feed was saved with one.
  • A deduction always affects the logged-in user only. A visitor can never take points from another account by typing its email.
  • The new account e-mail with a link to set a password is on by default, and the notice to the administrators is off.

Once for Every Entry

Each entry is rewarded once by each feed. The add-on marks the entry before it moves anything, so running the feeds again, resending notifications or editing the entry in the admin never rewards a second time. A note says Already rewarded by this feed. For a bonus that should go to every member only once, tick Once per user, and the next entries of that member are skipped with a note.

Gate a Form by Points or Rank

Change the action to Hide or block the form unless the user has enough points or a rank. This feed does nothing when the form is sent. It decides what the visitor sees and what the form accepts.

The form gate settings: the points type, the points needed, the rank needed, hide or block mode and the message with the missing points
A gate hides or blocks the form for people who have not earned it yet.
  • Points type and points needed: the user needs at least that many points. Leave it empty for no points rule.
  • Rank needed: the user needs that rank or a higher one of the same rank type. With both rules set, the user needs both.
  • Hide the form and show the message, or show the form with the message and refuse the submission.
  • Message: plain text. Use the points the user has, the points needed, the points missing, the points type and the rank needed in curly braces. The default message says how many points are needed and how many the user has.

A visitor who is not logged in has no points, so the message includes a link to log in. A submission that is sent anyway, for example by a script, is refused in both modes. An inactive gate does nothing. With no GamiPress or no license the gate stays open, so a form is never locked by accident.

Merge Tags and Prefill

Merge tag Value
gamipress_points in curly braces The points of the member in the first points type. Add a colon and the type slug, such as gamipress_points:coin, for another type.
gamipress_rank in curly braces The title of the rank of the member. A rank type slug can follow a colon.
gamipress_achievements in curly braces The number of achievements the member holds. An achievement type slug can follow a colon.
gamipress_awarded in curly braces The points this entry moved, for example 40 or -30. Add a colon and a type slug for one type.
gamipress_new_balance in curly braces The balance of the member after the entry.

The tags work in confirmations and notifications, and in the default value and placeholder of a field, where they show the balance of the logged-in member. They appear in the merge tag list of the form editor. You can also fill a field by a parameter name: switch on dynamic population for the field and use gamipress_points_coin, gamipress_rank_level or gamipress_achievements_badge. The value always comes from the logged-in user. A value in the page address can not override it.

Each entry gets a note for every step: the account that was made, the points that moved with the balance before and after, the achievement, the rank, and the reason for anything that was not done.

For Developers

The add-on calls gamipress_award_points_to_user, gamipress_deduct_points_to_user, gamipress_award_achievement_to_user and gamipress_update_user_rank, and reads balances with gamipress_get_user_points, ranks with gamipress_get_user_rank_id and achievements with gamipress_get_user_achievements. Because everything goes through GamiPress, the filters gamipress_allow_award_points_to_user and gamipress_allow_deduct_points_to_user can stop a move, and the GamiPress actions run as for any other award. The filter gfxgamipress_gate_verdict changes the result of a gate for a form and a user.

Limits to Know

  • The add-on does not take or return payments. Use a payment add-on, and tick the option to reward only when the payment is completed.
  • It does not take points back when an entry is deleted or a payment is refunded. Use a deduction feed for that.
  • GamiPress never lets a balance fall below zero.
  • A gate works on the page the form is shown on. It does not protect a page that is not a form.

Frequently Asked Questions

Do I need a paid GamiPress add-on?

No. The add-on works with the free GamiPress plugin from wordpress.org.

Can I use it with the free GamiPress Gravity Forms integration?

Yes. The free integration adds events for achievement steps. This add-on adds feeds that act on the entry. They do not interfere with each other.

Can a visitor give points to someone else?

Only if you set a feed to reward the account of a typed email, and only for points, achievements and ranks, never for a deduction. An account that can manage the site is never rewarded this way.

What happens when the amount field is empty or not a number?

Nothing is moved and the entry gets an error note. A negative amount, zero, or an amount below one point moves nothing either.

Does it send data outside my site?

No. Everything happens on your own site. Only the license check talks to gravityextra.com, when you press Activate.

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