Shopify Settings & Point Rules.
Configure how points are calculated and when they're awarded for Shopify purchases.
⚠️ Alpha Feature: The Shopify integration is currently in alpha testing and is not officially supported. Features may change without notice. Not recommended for production use.
Fine-tune how your Shopify integration works—from point calculations to widget appearance. Access these settings from the Settings tab on your Shopify integration dashboard.
Accessing Settings
- Navigate to Integrations → Shopify in the partner sidebar
- Go to your connected Shopify store's dashboard
- Click the Settings tab
Loyalty Card Selection
The top of the Settings tab shows which loyalty card is linked to your Shopify integration. To change it:
- Click the Loyalty Card dropdown
- Select a different card from your club
- Click Save Settings
💡 Tip: Choose the card that best represents your Shopify store's rewards program. All Shopify purchases will earn points on this card.
Widget Customization
Customize how the widget appears to customers on your Shopify store:
Program Name
| Setting | Description |
|---|---|
| Field | Program Name |
| Max Length | 50 characters |
| Purpose | Display name shown in the widget header |
| Example | "Star Rewards", "VIP Points", "MyStore Loyalty" |
Choose a name that matches your brand and is easy for customers to recognize.
Primary Color
| Setting | Description |
|---|---|
| Field | Primary Color |
| Format | Hex color code (e.g., #FF5722) |
| Purpose | Accent color for buttons and highlights |
Use your brand's primary color for a cohesive look. The color picker helps you find the exact shade.
Widget Mode
| Mode | Behavior |
|---|---|
| Auto | Adapts to customer's system preference (light/dark) |
| Light | Always displays with light background |
| Dark | Always displays with dark background |
Recommendation: Use "Auto" unless your Shopify theme has a fixed color scheme.
Widget Position
| Position | Best For |
|---|---|
| Bottom Right | Most Shopify stores (default, unobtrusive) |
| Bottom Left | Stores with Shopify Inbox or chat widgets on the right |
| Top Right | Maximum visibility |
| Top Left | Alternative high-visibility option |
Choose a position that doesn't overlap with other floating elements on your Shopify store (like chat widgets or cookie banners).
Point Calculation
Points are calculated using your linked loyalty card's rules. The key settings are:
Points Per Currency
How many points customers earn per unit of currency spent.
Example: If your card earns 10 points per $1:
- $25 purchase = 250 points
- $69.50 purchase = 995 points
This is configured on your loyalty card, not in integration settings.
Rounding Strategy
How fractional points are handled:
| Strategy | Behavior | Example ($9.99 at 1pt/$1) |
|---|---|---|
| Down | Always round down (conservative) | 9 points |
| Up | Always round up (generous) | 10 points |
| Nearest | Standard mathematical rounding | 10 points |
Award Trigger
When points are credited to the customer:
| Trigger | When Points Are Awarded | Best For |
|---|---|---|
| Order Paid | Immediately when Shopify marks order as paid | Speed, customer satisfaction |
| Order Fulfilled | When order is fulfilled in Shopify | Fraud prevention |
Most Shopify stores use "Order Paid" for immediate gratification.
Refund Handling
When an order is refunded in Shopify:
| Scenario | What Happens |
|---|---|
| Full Refund | Points deducted from customer balance |
| Partial Refund | Currently logged but not processed |
Note: Partial refund handling is planned for a future release. Shopify partial refunds are recorded but points are not adjusted.
Saving Changes
After making changes:
- Review your settings
- Click Save Settings
- A success notification confirms the save
Changes take effect immediately for new visitors. Existing sessions may need to refresh to see widget updates.
Settings Best Practices
Program Name
- Be specific: "Star Rewards" is better than "Rewards Program"
- Keep it short: Fits better in the widget header
- Match your brand: Use the same name across all channels
Colors
- High contrast: Ensure text remains readable on your chosen color
- Brand consistency: Match your store's existing palette
- Test both modes: If using Auto mode, verify colors work in light and dark
Position
- Avoid overlaps: Don't place the widget where it covers important content
- Consider mobile: Test on phones where screen space is limited
- Check other widgets: If you have a chat widget, put them on opposite sides
Troubleshooting
Settings not saving
Cause: Validation error on one of the fields.
Solution: Check that:
- Program name is 50 characters or less
- Color is valid hex format (e.g.,
#FF5722) - A valid card is selected
Widget not updating after save
Possible causes:
- Browser cache — hard refresh (Ctrl+Shift+R)
- Shopify CDN cache — may take a few minutes to propagate
- Try viewing your Shopify store in an incognito window
Points not matching expected amount
Check these settings:
- Card rules: Verify points per currency on your loyalty card
- Rounding: Ensure rounding strategy matches your expectations
- Award trigger: Confirm when points should be credited
Wrong card linked
To change the linked card:
- Go to Settings tab
- Select the correct card from the dropdown
- Click Save Settings
Existing transactions remain on the original card. Only new purchases use the new card.
Advanced: E-Commerce Reward Settings
When creating rewards, you can configure e-commerce-specific discount settings:
| Setting | Description |
|---|---|
| Enabled for E-commerce | Whether this reward can be redeemed via widget |
| Discount Type | Percentage off or fixed amount |
| Discount Value | The discount amount (e.g., 10 for 10% or $10) |
| Code Prefix | Prefix for generated codes (e.g., "REWARD") |
Configure these in the E-Commerce tab when editing a reward. See Creating Rewards for details.
Related Topics
- Connecting Your Shopify Store — Initial setup guide
- Shopify Widget Installation — Installing the widget
- Creating Loyalty Cards — Card rules affect point calculation
- Creating Rewards — E-commerce discount settings
Note: As an alpha feature, official support is not available. Report issues via the feedback system, but resolution is not guaranteed.