Managing Gift Rules
This guide covers how to edit, organize, and maintain your gift promotion rules over time.
Viewing All Rules
Navigate to Ecommerce > Product Gifts to see all rules.
Sorting Options
Click column headers to sort by:
- ID (ascending/descending)
- Name (alphabetical)
- Min Order Value (low to high / high to low)
- Created Date (newest/oldest)
- Status
Filtering
Use the filter options to find specific rules:
- By Status: Show only Published or Draft rules
- Search: Find rules by name
Editing Rules
How to Edit
- Find the rule in the list
- Click the Edit button (pencil icon)
- Make your changes
- Click Save
What You Can Edit
| Field | Can Edit? | Notes |
|---|---|---|
| Name | ✅ Yes | Change anytime |
| Min Order Value | ✅ Yes | Affects future carts |
| Apply To | ✅ Yes | May affect current sessions |
| Products/Categories | ✅ Yes | Based on Apply To setting |
| Gift Products | ✅ Yes | Add, remove, or change |
| Status | ✅ Yes | Immediately affects visibility |
| Start/End Date | ✅ Yes | Controls when rule is active |
Important Notes on Editing
Active Rule Changes
Changes to published rules take effect immediately. Consider:
- Creating a new rule instead of editing active ones
- Testing changes during low-traffic periods
- Communicating changes to customers if significant
Managing Gift Products
Adding New Gift Options
- Edit the rule
- Scroll to Gift Products section
- Click Add Product
- Search and select the product
- Set quantity
- Save the rule
Removing Gift Options
- Edit the rule
- Find the gift product to remove
- Click the remove/delete button
- Save the rule
Changing Gift Quantities
- Edit the rule
- Find the gift product
- Update the quantity field
- Save the rule
Replacing Gift Products
If a gift product is discontinued:
- Edit the rule
- Remove the old product
- Add the replacement product
- Save the rule
Status Management
Activating a Rule
To make a draft rule active:
- Edit the rule
- Change Status to Published
- Save
Or use bulk actions:
- Select rules with checkboxes
- Choose "Publish" from bulk actions
- Apply
Deactivating a Rule
To temporarily disable without deleting:
- Edit the rule
- Change Status to Draft
- Save
When to deactivate instead of delete:
- Seasonal promotions (reactivate next year)
- Testing periods
- Temporary pauses
- Preserving rule configuration
Deleting a Rule
To permanently remove:
- Find the rule in the list
- Click Delete button
- Confirm deletion
DANGER
Deletion is permanent. The rule and all its gift product associations are removed.
Bulk Operations
Selecting Multiple Rules
- Click checkboxes next to rules
- Use "Select All" for all visible rules
Available Bulk Actions
| Action | Effect |
|---|---|
| Delete | Remove selected rules permanently |
| Change Status | Set all selected to Published or Draft |
Performing Bulk Actions
- Select rules using checkboxes
- Choose action from dropdown
- Click Apply
- Confirm if prompted
Scheduling with Dates
Future Start Dates
Set a future start date to:
- Prepare promotions in advance
- Coordinate with marketing campaigns
- Launch at specific times
The rule won't appear until the start date, even if Published.
Expiration Dates
Set an end date to:
- Run limited-time promotions
- Manage seasonal offers
- Auto-expire without manual intervention
The rule automatically stops appearing after the end date.
Date Strategy Examples
Weekend Flash Sale:
- Start: Friday 12:00 AM
- End: Sunday 11:59 PM
Holiday Season:
- Start: November 15
- End: January 2
Product Launch Week:
- Start: Launch day
- End: 7 days later
Organizing Rules
Naming Conventions
Adopt a consistent naming system:
[Category] - [Tier/Amount] - [Description]
Examples:
- All Orders - $50+ - Free Tote
- Electronics - $100+ - Bonus Cable
- Holiday - Gold Tier - Premium SetArchiving Old Rules
For rules you want to keep but not use:
- Edit the rule
- Add "ARCHIVED:" to the name
- Set status to Draft
- Clear dates
This keeps the configuration for reference.
Seasonal Rule Management
Before season:
- Review last year's rules
- Update gift products if needed
- Adjust minimum values
- Set new date range
- Publish when ready
After season:
- Review performance
- Note what worked
- Set to Draft
- Keep for next year
Monitoring Rule Performance
What to Track
- How many orders qualified?
- Which gifts were most selected?
- Did average order value increase?
- Are gift products in stock?
Manual Tracking
Currently track via:
- Order reports (count orders with gifts)
- Product reports (gift product "sales")
- Comparing AOV before/after promotion
Signs a Rule Needs Adjustment
| Sign | Possible Action |
|---|---|
| Low qualification rate | Lower minimum value |
| High qualification rate | Raise minimum or add tiers |
| One gift always chosen | Remove unpopular options |
| Gift always out of stock | Increase inventory or change gift |
| No impact on AOV | Review targeting or minimum |
Common Management Tasks
Increasing Minimum Value
When raising the bar:
- Consider customer expectations
- Make change during low-traffic period
- May want to add intermediate tier instead
Adding a New Tier
To create a new gift level:
- Create new rule with new minimum
- Set appropriate gift(s)
- Ensure no overlap conflicts
- Publish when ready
Handling Out-of-Stock Gifts
When a gift product runs out:
- Plugin automatically hides it
- Customers see remaining options
- Restock when possible, or
- Remove and add replacement
Emergency Deactivation
If you need to stop all gifts immediately:
- Go to gift rules list
- Select all rules
- Bulk action: Change to Draft
- Apply
Troubleshooting Management Issues
Can't Edit Rule
- Check your admin permissions
- Verify database connection
- Clear cache and try again
Changes Not Appearing
- Clear CMS cache
- Clear browser cache
- Test in incognito window
- Check date restrictions
Bulk Action Not Working
- Ensure rules are selected
- Try smaller batch
- Check for errors in logs
Best Practices
Regular Maintenance
Weekly:
- Check gift product stock levels
- Review any customer feedback
Monthly:
- Review rule performance
- Adjust minimums if needed
- Update seasonal rules
Quarterly:
- Full rule audit
- Archive inactive rules
- Plan upcoming promotions
Documentation
Keep notes on:
- Why each rule was created
- Performance results
- Changes made and why
- Customer feedback
Next Steps
- Customer Guide - See customer experience
- Troubleshooting - Fix common issues
- FAQ - Common questions
