Skip to main content

Manage customers

Find a customer, check their points and store credit, and manage their rewards, tier and loyalty emails from the Customers page.

The Customers page lists the customers in your loyalty program. Use it to find a customer, check their points and store credit, and see what they have earned, redeemed and received.

From a customer's page you can also give or remove points by hand, pull the latest details from Shopify, or take the customer out of the program.


Find a customer

In the Appstle Loyalty app, click Customers. Each row is one customer.

These columns show by default:

Column

What it shows

Customer Id

The Shopify customer ID. Click it to open the customer.

Name

The customer's name, with their email below it.

Phone

Their phone number, if they have one.

Points

Their current points balance.

Credits

Their current store credit.

Redeemed

The points they have redeemed.

Spent

What they have spent in your store.

Reward

The number of rewards they have been granted.

Tier

Their VIP tier. Empty when they have none.

Status

Active, Guest, Omitted or Omitted by customer. Guest means the customer hasn't activated an account in your store, or you set them to Inactive. Omitted means you excluded them, and Omitted by customer means they opted out. See Guest Customer and Exclude Customer.

Created At

When the customer was added to the app, in your store's time zone.

Action

Three icons: refresh (Sync Latest from shopify), eye (View Loyalty Details, the same as clicking the ID) and arrow (View Customer On Shopify).

Use the columns button above the table to show or hide columns. Shopify Tags, Last Activity and Points Expiry Date are off by default. The list goes back to the default columns when you leave the page.

Search, filter and sort

  • Search finds a customer by ID, email or name.

  • Filters narrow the list by First Name, Last Name, Phone Number, Vip, Available Points, Pending Points, Status, VIP Assignment Type, Order Count, Created Date, Earned Credits, Email Bounced or Shopify Tags. Non VIP shows only customers without a tier.

  • Sort orders the list by Create Date, Points or Credits, ascending or descending.

Buttons at the top

These buttons sit at the top of the Customers page:

Button

What it does

Export

Emails you a file of the customers that match your current search and filters. The store owner and staff with full access can export, plus any staff you allow in Advanced settings. The file goes to an address on your Merchant Notifications Email list.

Add Customer

Adds a customer from your Shopify store to the program. See Adding Customers.

Referrals

Lists every referral in your program: who referred whom, its status, the friend's order count and the dates.

Approve Pending Transactions

Opens the list of pending points or store credit. Approve them one at a time, a selection, or all at once. Schedule Store Credit Approval approves all pending store credit on a date and time you pick.

Work on several customers

Tick the boxes at the start of the rows. Two actions appear above the table:

  • Remove Customers deletes the selected customers from the app, with their points history, rewards and referrals. This can't be undone.

  • Unblock Emails clears the bounced or failed email flag on the selected customers, so loyalty emails can be sent to them again.

To remove more than 5,000 customers at once, use Bulk Operations, where you can upload a CSV file of customer IDs or emails.


Open a customer

Click the customer's ID, or the eye icon at the end of the row. The top of the page shows their name, email, status and VIP tier, or No VIP Tier.

A Manual Tier badge means the tier was set by hand, so the app doesn't change it automatically. A Referred By badge shows when another customer referred them, and their birthday shows next to their email when they have one.

Actions at the top of the page

These buttons sit at the top of the customer's page, next to their name:

Action

What it does

Referral Link

Copies the customer's referral link. It shows only for customers who have one. If your referral program is off, a banner on the page says the link won't open the offer.

Sync Customer

Takes the latest details from Shopify and updates the customer if anything doesn't match.

Exclude from program

Takes the customer out of the program. They no longer see your loyalty launcher or page and stop earning, and they aren't notified. For a customer who is already out, the button reads Include into Program. See Exclude Customer.

Sync Order

Asks for a Shopify Order ID and runs that order through your earn rules. Use the long number at the end of the order's URL in Shopify admin, not the order name such as #1001. The points go to the customer on that order.

Manage customer

Opens the menu in the next section.

With Sync Order, only the items the customer kept earn points. It doesn't run an order that was already synced, was fully refunded, or had every item returned, exchanged or removed.

It tells you why instead. For a refunded or returned order, the reason is also saved in the Activity Logs of the customer on that order.

The Manage customer menu

Click Manage customer to open these actions. Some show only when they apply:

Menu item

What it does

Edit Customer

Change the customer's Date of birth, Status and Enable Email. Inactive shows as Guest in the list. When Enable Email is off, the customer gets no loyalty emails. A Status or Enable Email you change here stays as you set it, even after the customer syncs from Shopify.

Give Points/Credits and Remove Points/Credits

Change a balance by hand. See Give or remove points and store credit by hand.

Remove Customer's Tier

Shows only for a customer who has a tier. It removes the tier and its tags from the customer's Shopify profile and marks them Manual Tier, so the app stops giving them a tier automatically.

Recalculate VIP Tier

Shows only when your VIP program is on. It recounts the customer's spend, orders or points and moves them to the tier they qualify for now, so their tier can go up, go down or be removed. Rewards for lower tiers aren't issued.

View Metafields

Lists the customer's metafields (Namespace, Key, Type and Value).

Unblock Email

Shows only when the customer's email bounced or failed. It lets loyalty emails go to that address again.

Delete Customer

Deletes the customer from the app, with their points history, rewards and referrals. The app asks you to confirm first. This can't be undone.


Read the balances

The cards under the customer's name sum up their loyalty account:

Card

What it shows

Current Points

The points the customer has now. Pending points aren't included.

Current Credits

Their store credit, synced with Shopify. If they hold credit in more than one currency, use the currency button on the card to switch.

Total Credits Earned

Store credit issued by earn rules and manual adjustments, over their lifetime. It differs from Current Credits when the customer has credit from rewards or has spent some.

Total Points Earned

Points earned over their lifetime, less points taken back for refunded or cancelled orders. Redeemed points stay included.

Pending Points

Points waiting for approval.

Activities Completed

How many earn activities they have completed.

Rewards Granted

How many rewards they have been given, used and unused. Rewards include discount codes, free products, free shipping and store credit.

Spent Amount

Their lifetime spend, as Shopify reports it.

Some cards show only when they apply:

  • Points Expire Date shows when the customer's points will expire, based on their last activity and your point expiry settings.

  • VIP Tier Expires shows when their tier will be re-evaluated, with a countdown.

  • VIP Qualifying Spend or VIP Qualifying Orders shows the figure your VIP program counts, for programs based on spend or on orders.

  • Store credit breakdown shows when Current Credits differs from Total Credits Earned. It splits the balance into From earn rules & adjustments and From rewards & perks, with View History and View Rewards links. When the customer has spent more credit than their rewards gave them, the second row reads Net of redemptions over rewards.


Check what a customer earned and received

Four tabs sit below the cards.

History

Every points and store credit transaction, from earn rules, redemptions, refunds and manual adjustments. Transactions from an order are grouped under that order with its net points. The rest are under Not linked to an order.

The Balance column shows the customer's points balance right after that transaction. Pending and rejected transactions and store credit rows show a dash, because they don't change the points balance.

Use the search and filter button to filter by Transaction Type, Status, Point Type or Created Date.

In the Action column, Approve confirms a pending transaction: its points become available to redeem, and store credit is added to the customer's Shopify store credit account. Cancel rejects a transaction that added points or store credit, approved or pending. Approved points and credit are taken back. A pending row was never added to the balance, so cancelling it only rejects the row. You can add a reason. See Give or remove points and store credit by hand for the details.

Rewards

The rewards this customer has received: discount codes, free products, free shipping and store credit. Each row shows its type, value, status, code, the redeem rule or VIP tier it came from, and its dates.

The status is Used, Unused, Refunded, Canceled or Expired. Rewards from a VIP tier cost no points, so they don't show in History.

The Actions menu has two items:

  • Create Redeem gives the customer a reward from your redeem rules. In the Choose Rewards Rule window, pick a rule and click Create Redeem. The points the rule costs come off the customer's balance, the reward appears in the list, and the app sends the customer your Point Redeem email, if that email is on. Rules that cost more than the customer has are greyed out. For customers who are Omitted or Omitted by customer, the app shows "This customer is omitted from the loyalty program, so no reward was created." No reward is created and no points come off.

  • Sync Missing Discount Codes is available when a reward has no discount code yet. It asks Shopify for the missing codes and tells you how many it found.

Cancel Reward shows on rewards that are Unused or Used. The app asks you to confirm first.

  • For an unused reward, it adds the redeemed points back and removes the discount code. The status changes to Refunded.

  • For a used reward, it adds the points back, but the code stays on the order it was used on.

  • To cancel an unused reward without returning the points, untick Reassign redeemed points to customer.

  • For a store credit reward, the credit is taken back only when the points are returned. If you untick the box, the credit stays in the customer's balance.

Referrals

The friends this customer has referred, with each referral's status and its create and claim dates. Click Delete to remove a referral that is still pending.

Activity Logs

A log of what the app did for this customer: points earned and redeemed, VIP tier changes, referrals, refunds and emails. Each row has a status, the order and product when there are any, and a note.

Click More Info on a row for the details. The search and filter button filters by Log Type, Event Type, Event Source, Status, order ID or order name.


Things to know

  • The app gets customers from your Shopify store. A customer must exist in Shopify before you can add them.

  • Points leave a customer's balance when a reward is issued to them, not when they use it.

  • Whether Enable Email is on for a customer follows Send Emails To in Advanced settings, which is Active Customers by default. So Guest customers get no loyalty emails unless you change that setting or turn Enable Email on in Edit Customer. A changed setting reaches each customer the next time they sync from Shopify, except customers whose Enable Email you changed in Edit Customer.

  • Delete Customer and Remove Customers delete the customer's loyalty records only. The customer stays in your Shopify store.

  • Deleting a customer in Shopify keeps their loyalty records in the app, unless you turn on Delete Customer On Deleting From Shopify in Advanced settings.


FAQs

A customer's points or credit look out of date. What can I do?

Open the customer and click Sync Customer. It takes the latest details from Shopify and corrects anything that doesn't match. The sync runs in the background, so refresh the page after a moment.

Why isn't a customer in the list?

Clear the search and filters first. If they're still missing, it's usually one of these:

  • Require Customers to Opt In to the Loyalty Program is on in Advanced settings. Customers then appear only after they join from your loyalty widget or page.

  • Their email or email domain is listed in Restrict Customer Accounts by Email in Advanced settings.

  • The Appstle Loyalty app embed was off in your theme when they signed up. New customers aren't added while it's off.

To add someone by hand, use Add Customer. They need to be in your Shopify store first.

Why didn't a customer get points for an order?

Open the customer's Activity Logs tab and find the order. Its note says why it didn't earn, for example that the app embed was off. Fix the cause, then click Sync Order and enter the order's ID to run it again.

Why didn't a customer get an email?

Open Manage customer → Edit Customer and check that Enable Email is on. Then look in their Activity Logs for a failed Email row, which says why the email wasn't sent. If their email bounced, use Unblock Email on their page.

Did this answer your question?