Skip to Content
Account
Enter the email address on your account.
Forgot Your Username?
Enter your password.
Forgot Your Password?

Or continue with

J2Commerce 6

Gifter Pro

15 Min Read

Documentation current for Gifter Pro v6.0.2. Last checked November 22, 2026.

On This Page

Gifter Pro adds a free gift to qualifying carts based on rules you set. A rule can give a gift on a customer's first order, once per customer, or on every qualifying order, and it can add the gift automatically or let the customer choose one.

Gifter Pro checks each customer against earlier orders by account, email, phone and address, so the same person does not collect a first-order gift twice. It also falls back to another gift when the first one is out of stock and keeps a ledger of every gift given.

Requirements

  • Joomla 6.0 or later (PHP 8.3 or later)
  • J2Commerce 6.6.4 or later, installed and enabled

Info

Gifter Pro needs J2Commerce 6.6.4 or later.

Installation

Purchase and Download

Gifter Pro is a separate add-on available from the J2Commerce Extensions Store. It is not included with the core J2Commerce 6 component.

  1. Go to Gifter Pro on the J2Commerce Extensions Store -> Apps.
  2. Find Gifter Pro and click View Details -> Add to Cart -> Checkout.
  3. Open My Downloads under your profile button, search for Gifter Pro, then click Available Versions -> View Files -> Download Now.

Install the App

  1. In the Joomla Administrator, go to System -> Install -> Extensions.
  2. Upload the Gifter Pro ZIP file, or use the Install from URL tab.
Joomla System Dashboard with System in the sidebar and the Install Extensions link highlighted to open the extension installer

Enable the App

Installing does not enable the app.

  1. Go to Components -> J2Commerce -> Apps.
  2. Search for Gifter Pro.
  3. Click the red X in the status column. It turns into a green checkmark.

Where to Find It

Open J2Commerce -> Apps -> Gifter Pro to reach the plugin settings. The toolbar of that screen has two extra buttons: Dashboard and Manage Gift Rules.

Gifter Pro has four screens, linked from each other's toolbars:

  • Gift Rules: create, edit, publish, duplicate and delete rules.
  • Dashboard: gift totals for a date range.
  • Gift Ledger: every gift reserved, given or recorded by hand.
  • Blocked Attempts: customers refused a repeat gift and extra free units that were capped.

The screens need the Access Administration Interface permission for J2Commerce.

Plugin Settings

These settings apply to every rule. They are on the plugin screen, split over five tabs.

General Settings

Gifter Pro plugin settings on the Plugin tab, with Enable Gifts Shop-Wide, Gift Weight Counts Toward Shipping and Debug Log
SettingWhat It DoesDefaultOptions
Enable Gifts Shop-WideNo stops every rule and removes any gift already in a cart. Rules and the ledger are kept.YesYes, No
Gift Weight Counts Toward ShippingYes includes the gift's weight in shipping rates.YesYes, No
Debug LogWrites extra detail to the plugin log file.NoYes, No

Customer Matching

Customer Matching tab with Block or Flag chosen for account, email, phone, name and address, and address-only matches, plus the Gmail alias and +tag switches, prior-order statuses and reservation times

Each match key has its own mode for a customer who matches an earlier order or gift:

  • Block: a match stops the gift.
  • Flag: a match lets the gift through but marks it for review in the ledger.
  • Off: the key is ignored.
SettingWhat It DoesDefaultOptions
Match by AccountMatches the Joomla user account.BlockBlock, Flag, Off
Match by EmailMatches the email address.BlockBlock, Flag, Off
Match by PhoneMatches the phone number.BlockBlock, Flag, Off
Match by Name and AddressMatches the name together with the address.BlockBlock, Flag, Off
Match by Address OnlyMatches the address alone. Households and roommates share an address, so the default is Flag.FlagBlock, Flag, Off
Treat Gmail Aliases as One AddressIgnores dots and +tags in Gmail addresses, so This email address is being protected from spambots. You need JavaScript enabled to view it. and This email address is being protected from spambots. You need JavaScript enabled to view it. match.YesYes, No
Ignore +tags on Every DomainMakes This email address is being protected from spambots. You need JavaScript enabled to view it. match This email address is being protected from spambots. You need JavaScript enabled to view it..YesYes, No
Statuses That Count as a Prior OrderThe order statuses that make a customer a returning customer. Leave empty to use every completed, approved, shipped, delivered and open status on the store.EmptyYour order statuses
Reservation Grace (Minutes)How long a gift reserved on an unpaid order is protected.301 or more
Reservation Expiry (Hours)How long an unpaid reservation lasts before it is released.241 or more

Cancel and Refund

Cancel and Refund tab set to release the gift when an order fails or is cancelled and to keep it counted when an order is refunded

These settings decide what happens to a customer's gift allowance when an order does not complete. Release the Gift lets the customer receive the gift again. Keep the Gift Counted means the customer cannot receive it again.

SettingWhat It DoesDefaultOptions
When an Order FailsApplies when the order gets a failed status.Release the GiftRelease the Gift, Keep the Gift Counted
When an Order Is CancelledApplies when the order is cancelled.Release the GiftRelease the Gift, Keep the Gift Counted
When an Order Is RefundedApplies when the order is refunded.Keep the Gift CountedRelease the Gift, Keep the Gift Counted

Notifications

Notifications tab with the Email Store Admin on Gift Orders switch
SettingWhat It DoesDefaultOptions
Email Store Admin on Gift OrdersSends one email per order when the order's free gift is confirmed by a paid or placed order status. Unpaid orders send nothing.NoYes, No
Notification RecipientsComma-separated email addresses. Leave empty to use the store's order email addresses. Shown when the setting above is Yes.EmptyEmail addresses

Privacy

Privacy tab with Keep Blocked Attempts set to 90 days and Keep Gift Ledger on Uninstall set to Yes
SettingWhat It DoesDefaultOptions
Keep Blocked Attempts (Days)Blocked attempts older than this are removed automatically. 0 keeps them until you purge them.900 or more
Keep Gift Ledger on UninstallYes keeps the rules and gift records in the database when the plugin is uninstalled. No deletes them.YesYes, No

Create a Gift Rule

Gift Rules list with one published rule, its gift, a limit of 1 per order and 1 per customer, and the number of gifts given
  1. Open J2Commerce -> Apps -> Gifter Pro and click Manage Gift Rules.
  2. Click New.
  3. Enter a Title and choose a Trigger.
  4. On the Gift tab, choose a Delivery mode and add at least one gift.
  5. Set any Conditions and Limits.
  6. Click Save & Close.

Details Tab

Details tab of a gift rule with the title, the Once per Customer trigger, the customer group, Stop Further Rules and the start and end dates
SettingWhat It DoesDefaultOptions
TitleA name for the rule. Shoppers never see it.RequiredText
TriggerFirst Order: only customers with no earlier order. Once per Customer: each customer receives the gift once, whenever they qualify. Every Order: every qualifying order receives the gift.RequiredFirst Order, Once per Customer, Every Order
Once-per-Customer GroupRules in the same group share one allowance. A customer who receives a gift from one of them does not receive another from the group, and an order gets at most one gift per group.defaultGroup name
Stop Further RulesWhen this rule gives a gift, every rule below it in the list is skipped.NoYes, No
StartsThe rule applies from this date and time. Leave empty to start immediately.EmptyDate and time
EndsThe rule stops applying after this date and time. Leave empty to run until disabled.EmptyDate and time
Internal NoteA note only store staff see.EmptyText
StatusOnly published rules give gifts.PublishedPublished, Unpublished

Gift Tab

Gift tab set to Add Automatically, with the removal, also sold normally and backorder switches and one primary gift with its variant
SettingWhat It DoesDefaultOptions
DeliveryAdd Automatically puts the gift in the cart as soon as the cart qualifies. Customer Chooses One shows the gifts in the cart and adds the one the customer picks.Add AutomaticallyAdd Automatically, Customer Chooses One
Customer May Remove the GiftNo: a removed gift returns the next time the cart loads. Yes: a removed gift stays out for the rest of the visit, and the cart shows an Add My Gift Back button.NoYes, No
Gift Is Also Sold NormallyUse when the gift product is also for sale. A paid unit and the free gift always stay on separate cart lines.YesYes, No
Give Backordered GiftsYes: a gift that is out of stock but open to backorders is still added. No: it counts as out of stock and the next fallback gift is used.NoYes, No

Click Add Gift to add a gift row, then choose its Role, Product and Variant. Rows can be moved up and down.

  • With Add Automatically, mark exactly one gift as Primary and any number as Fallback. A fallback is used when the primary is out of stock, in the order listed.
  • With Customer Chooses One, every gift in the list is offered to the customer.

Note

A gift can be a simple, downloadable, variable or flexible variable product. Choose a specific variant: the main variant of a variable product cannot be a gift. Subscriptions, bundles, kits, box and guided builders, grouped and configurable products cannot be gifts, and neither can products with required options the variant does not set.

Conditions Tab

Conditions tab with Minimum Subtotal, Include Tax in Subtotal, Required Products, Required Categories, Match, User Groups, Require Login and Geozones

Leave a condition empty to skip it. A cart must meet every condition that is set.

SettingWhat It DoesDefaultOptions
Minimum SubtotalThe cart subtotal needed to earn the gift, measured after coupon and cart discounts and before shipping. Vouchers do not reduce it. The gift itself never counts. Checked again at checkout.EmptyAmount
Include Tax in SubtotalYes: tax counts toward the minimum subtotal. No: the subtotal is measured before tax.NoYes, No
Required ProductsProducts the cart must contain.EmptyProducts
Required CategoriesThe cart must contain a product from these categories or their subcategories.EmptyCategories
MatchAny Required Item: one of the required products or categories is enough. All Required Items: every one must be in the cart.Any Required ItemAny Required Item, All Required Items
User GroupsOnly members of these groups qualify.Empty (everyone)User groups
Require LoginYes: guests do not receive the gift.NoYes, No
GeozonesThe customer's tax address (shipping, otherwise billing) must be inside one of these geozones.Empty (everywhere)Geozones

Limits Tab

Limits tab with Maximum Free Gifts per Order and per Customer set to 1 and Count Free Gifts From set to This App Only
SettingWhat It DoesDefaultOptions
Maximum Free Gifts per OrderFree units of this rule's gift allowed in one order. 0 means no limit.10 or more
Maximum Free Gifts per CustomerFree units of this rule's gift one customer can ever receive. 0 means no limit.10 or more
Count Free Gifts FromThis App Only counts only the gifts Gifter Pro gives. All Apps (Global) also counts free units of the same product given by other extensions.This App OnlyThis App Only, All Apps (Global)

When a limit is reached, extra units are charged at the regular price and the cart says so, for example "Limit 1 free Tote Bag per order. Extra units are charged at the regular price."

Messages Tab

Messages tab with the progress, gift added, returning customer, guest teaser and product page messages, each showing its default wording

Each message replaces the default wording shown in the field. Leave a field empty to keep the default.

SettingWhat It DoesDefaultOptions
Progress MessageShown in the cart while the subtotal is short. %1$s is the amount still needed and %2$s is the gift name.Spend %1$s more to get a free %2$s.Text
Gift Added MessageShown after the gift is added. %1$s is the gift name.Your free %1$s has been added.Text
Returning Customer MessageShown to a returning customer who does not qualify.Our free gift is for first orders. Thanks for coming back!Text
Guest TeaserShown to a guest before an email address is known.New customer? Your free gift is confirmed at checkout.Text

Eligibility Check Tab

Eligibility Check tab with email, phone and ZIP code fields and a Check Eligibility button

Use this tab to see whether a customer would receive the gift and which earlier order stops them. Enter an Email or Phone (and optionally a ZIP Code), then click Check Eligibility.

Save a new rule before you check a customer.

What Shoppers See

Cart below the minimum spend, with a message giving the amount still needed for the free gift, and a Choose Your Free Gift box offering two gifts
Cart with the free gift added at $0.00 with a Free Gift badge, followed by the messages that the gift was added and is confirmed at checkout
  • The gift appears as its own cart line with a Free Gift badge. Its quantity cannot be changed.
  • The cart shows the progress, gift added, returning customer or guest message that applies.
  • With Customer Chooses One, the cart shows Choose Your Free Gift with the gifts to pick from.
  • A backordered gift shows "Ships when back in stock".
  • A free gift does not count as the qualifying product for a coupon.

If the email or address entered at checkout matches an earlier gift, the gift is removed and the shopper sees "Your free gift was removed because this email or address has already received one. Please review your order."

If a discount brings the order below a rule's Minimum Subtotal, the gift is removed at checkout and the shopper sees "Your free gift was removed because your order is below the minimum after discounts. Please review your order." The attempt is logged under Blocked Attempts.

Cart layouts are included for both the Bootstrap 5 and UIkit subtemplates. Gifter Pro is translated into 22 languages.

Gift Ledger

Gift Ledger list with the date, order, customer, rule, source, gift, value and status of each gift

The Gift Ledger lists every gift claim with its date, order, customer, rule, source, value, status and flag. Search by order number, email or name, and filter by status, rule, source, flag or date.

StatusMeaning
ReservedThe gift is held for an order that is not paid yet.
GivenThe order was confirmed and the gift counts for the customer.
ReleasedThe claim was freed, for example by a failed or cancelled order. The customer can receive the gift again.
VoidedA store admin voided the claim. It stops counting.
ManualRecorded by hand with Grant Gift Manually.
ConflictThe order was paid after the same customer's gift had already been given on another order.

Toolbar actions:

  • Release and Void: select claims first. Both make those customers eligible for the gift again.
  • Grant Gift Manually: records that the customer of an order already received a rule's gift, so they are not offered it again. No gift is added to the order.
  • Run Backfill: makes orders placed before Gifter Pro was installed count as earlier orders. You can run it more than once.
  • Import Past Free Gifts: choose a rule and an Orders Since date. Customers who received that gift free on a past order are recorded as Given, with the source History Import.
  • Export CSV: downloads the filtered list.

Tip

On a store that already has orders, run Run Backfill once after installing. Without it, customers who ordered before Gifter Pro was installed can still qualify for a first-order gift.

Blocked Attempts

Blocked Attempts logs each time a customer is refused a repeat gift, a gift is removed at checkout, or extra free units are capped. Each row shows the date, rule, stage (Cart, Discount, Confirm, Payment or Status Change), action, the matched key type and the order or cart.

Purge Older Than permanently deletes attempts older than the number of days you enter (1 to 3650). Use Export CSV first if you need a copy.

Dashboard

Gifter Pro Dashboard with gifts given, gift value, unique recipients, repeat gifts blocked, stock and limit counts, a daily chart and the top rules

The Dashboard shows, for a date range you choose:

  • Gifts Given, Gift Value Given and Unique Recipients
  • Repeat Gifts Blocked, Extra Gifts Capped and Gifts Out of Stock
  • a daily chart of gifts given, blocked and capped, with the same figures in a Daily Totals table
  • Top Rules by Gifts Given and Sources Capped Most

Gift Conflicts

Gifter Pro card on an order with the warning Gift conflict: do not ship the gift, and the gift status set to Conflict

A conflict happens when an order is paid after the same customer's gift was already given on another order. Gifter Pro marks the claim as Conflict and warns you in two places:

  • An email titled "Gift conflict on order ...: do not ship the gift" goes to the store's order email addresses.
  • The order screen shows a Gifter Pro card: "Gift conflict: do not ship the gift".

Warning

Check the Gift Ledger before you pack an order that shows a conflict. The gift on that order should not ship.

Common Setups

Free Gift on the First Order

  1. Create a rule with Trigger set to First Order.
  2. Set Delivery to Add Automatically and add one Primary gift and one or two Fallback gifts.
  3. Keep the default limits of 1 per order and 1 per customer.

Free Gift Over a Minimum Spend

  1. Create a rule with Trigger set to Every Order.
  2. On the Conditions tab, enter a Minimum Subtotal.
  3. Edit the Progress Message if you want different wording for the "spend more" prompt.

Let Customers Pick a Gift

  1. Set Delivery to Customer Chooses One.
  2. Add every gift the customer can choose from.

One Gift Across Several Rules

Put the rules in the same Once-per-Customer Group. A customer then receives one gift from the group, and an order gets at most one gift per group.

Troubleshooting

No Gift in the Cart

  • Enable Gifts Shop-Wide is set to No.
  • The rule is unpublished, or the date is outside Starts and Ends.
  • The cart does not meet a condition, such as the minimum subtotal (after discounts), required products, user groups, login or geozone.
  • Every gift in the rule is out of stock, and Give Backordered Gifts is No.
  • A rule higher in the list has Stop Further Rules set to Yes.

A New Customer Is Refused the Gift

Open the rule and use the Eligibility Check tab with the customer's email or phone. It names the earlier order and the match key that stopped them. If the match is a shared address, set Match by Address Only to Flag or Off.

A Returning Customer Got the Gift

Their earlier order may predate Gifter Pro. Run Run Backfill on the Gift Ledger screen, and use Import Past Free Gifts for gifts given before Gifter Pro. Also check that the earlier order's status is in Statuses That Count as a Prior Order.

Enable Debug Logging

Set Debug Log to Yes to write extra detail to the plugin log file. Turn it off again when you are done.

Uninstalling

Before you uninstall, decide whether to keep the data. With Keep Gift Ledger on Uninstall set to Yes, the rules and gift records stay in the database and are used again if you reinstall.

Warning

With Keep Gift Ledger on Uninstall set to No, uninstalling deletes every rule, gift record and blocked attempt. This cannot be undone.

  1. Go to System -> Manage -> Extensions.
  2. Search for Gifter Pro, select it and click Uninstall.

Related Products

Related Products

Still stuck? Our team can help.

Back to Top