Skip to main content

Bulk operations: change many customers at once

Use Bulk Operations in Appstle Loyalty to give or remove points, assign VIP tiers, import past orders, send rewards and more for many customers at once.

Bulk Operations let you do one job for many customers at once, such as giving points to everyone, moving a group of customers to a VIP tier, or importing past orders. Each operation runs in the background, so you can leave the page while it works.

To open them, go to More → Bulk Operations in the app. Each card is one operation. Click Configure on a card to set it up.


Before you start

  • Bulk Operations is included in the Business plan and above. Email Customers About Unredeemed Rewards needs Business Premium or above.

  • Only one operation runs at a time. While one runs, a badge at the top of the page shows its progress and every Configure button is grayed out. Start the next one when the badge disappears.

  • Check your settings before you click the final button. Importing past orders, combining accounts and deleting customers can't be undone.

  • Try an operation on one customer first, then open that customer's page and check the result.

  • A customer ID is the number at the end of the customer's page address in Shopify admin. You can use email addresses instead of IDs in most operations.


Choose which customers to include

Most operations let you choose customers in more than one way. This table shows what each one accepts.

Operation

How to choose customers

Adjust Points or Store Credits

All customers, or any mix of tags, customer IDs, emails and a CSV file

Assign VIP Tiers in Bulk

Any mix of tags, customer IDs, emails and a CSV file

Recalculate VIP Tiers

All customers, or any mix of customer IDs, emails and a CSV file

Issue Rewards to Customers

All customers, or any mix of a VIP tier, tags, customer IDs and emails

Delete Customers from Program

Customer IDs or a CSV file. If you upload a CSV, the IDs you typed are ignored.

When you use more than one, a customer is included if they match any of them. Customers who aren't in your loyalty program are skipped.

A CSV file needs an email column, a customer_id column, or both. Click Download sample CSV in the window to get a template. In the tag, ID and email fields, press Enter or Tab after each entry. In Adjust Points or Store Credits, separate customer IDs and emails with commas.


Adjust points or store credits

Give, remove or set points or store credit for all customers or for a group. The window is titled Adjust Points or Adjust Store Credits, depending on the reward type you pick.

  1. Click Configure on Adjust Points or Store Credits.

  2. Choose a Reward Type: Points or Store Credits.

  3. Choose an Adjustment Type: Give Points, Remove Points or Set Points (for store credit, Give Store Credits, Remove Store Credits or Set Store Credits). Set changes each customer's balance to the number you enter.

  4. Under Select Customer type, choose All Customers or Specific Customers. For specific customers, add tags, customer IDs or emails, or upload a CSV.

  5. Enter the Points Value (or Store Credits Value). For giving or removing points, choose Fixed or Percentage%. A percentage works from each customer's current balance, so customers with 0 points are skipped. Store credit and Set always use a fixed amount.

  6. When you give or set store credit, choose an Expiration: Store default, 1 year from today, 3 years from today or On a specific date. It applies to every customer in this run.

  7. Edit the Note if you like. It shows in each customer's history. {{value}} becomes the amount, and {{type}} becomes "added" or "removed".

  8. Click Adjust.

To give each customer a different amount, add a points column to your CSV. A blank amount uses the value in the window, 0 skips that customer, and a negative number does the opposite of the adjustment type you chose.


Import past orders

Award points for past orders that haven't earned points yet, such as orders placed before you installed the app. Each order earns points the way a new order would, based on your current ways to earn.

Because each order is handled like a new one, customers get your Point Earn or Credits Earn email if it's turned on, and referral rewards and VIP tiers can update too. To avoid emailing customers about old orders, turn those emails off in More → Email Templates until the import finishes. New orders placed in the meantime won't send them either.

If points stay pending for a set number of days, that period counts from the original order date.

Turn on the app embed first. The Import orders button stays grayed out while the app embed is off. A banner tells you, with an Activate app embed button that opens your theme editor. Orders are only processed while the app is active.

  1. Click Configure on Import Past Orders.

  2. To import for one customer only, enter their ID in Customer ID (optional). Leave it empty for all customers.

  3. Under Orders to import, choose Give points for all orders, Give points for open orders (not archived) or Give points for archived orders. Paid and fulfilled orders, including POS sales, are usually archived automatically.

  4. Under Sales channel, choose All, Web or POS.

  5. To limit the import to certain dates, select Only import orders placed between specific dates and pick the range.

  6. Check the order count at the bottom of the window, then click Import orders.

The import can't be stopped once it starts, and the points it awards can't be reverted. While it runs, an Importing past orders badge with the number of orders processed shows at the top of Bulk Operations. When the badge disappears, the import is done.

The Previous imports list in the window shows each run's start time, the order dates it covered and its status: Processing, Completed, Stopped early or Status not recorded yet. A new run can take a little while to appear.

Orders that don't earn points

  • Orders that already earned points, and cancelled orders, are skipped.

  • Fully refunded orders are skipped.

  • For a partly refunded order, points are based on the items the customer kept.

  • Orders from customers who can't earn: customers you excluded from the program, customers your Advanced Settings restrict, and customers who haven't joined when your program requires opt-in.

  • Orders that none of your active ways to earn apply to.

When an imported order earns nothing, the customer's Activity Logs tab says why.


Award points for a single order

Process one order by its ID so the customer earns points for it.

  1. Click Configure on Award Points for Single Order.

  2. Enter the Order ID. This is the long number at the end of the order's page address in Shopify admin, not the order number such as #1001.

  3. Click Award Points.

If the order already earned points, the app tells you to check the customer's points history. If it can't earn, for example because it was fully refunded, the app tells you why.


Assign VIP tiers in bulk

Move a group of customers into one VIP tier, whatever their points or spend.

  1. Click Configure on Assign VIP Tiers in Bulk.

  2. Choose a Tier Assignment Behavior (see the table below).

  3. Under VIP tier to assign, choose the tier.

  4. Pick customers with Filter by customer tags, Filter by customer IDs, Filter by customer emails or a CSV. You can combine them, and you need at least one.

  5. Select Send tier rewards if customers should get the discount codes or bonus points set for the tier.

  6. Click Assign tier.

This table explains the three tier assignment behaviors.

Behavior

What happens after the assignment

Renew on achieving higher tier (the default)

Customers move up when they qualify for a higher tier, but never move down.

Auto renewal

Customers move up or down as they qualify, like everyone else in your program.

Manual

The tier is locked. Customers stay in it whatever they earn or spend. To change it, run this operation again, or recalculate them with Include customers with a manually assigned tier.

Tier rewards are sent once. Customers who already hold a tier's rewards don't get them again, unless those rewards were cancelled or refunded. Birthday rewards aren't sent here: they're issued automatically on each customer's birthday.


Recalculate VIP tiers

Re-check which tier customers belong in, using your current tier settings.

  1. Click Configure on Recalculate VIP Tiers.

  2. To recalculate everyone, leave the filters empty. To recalculate a group, add customer IDs or emails, or upload a CSV.

  3. Select Allow amount-spent and orders-placed tier downgrades if customers whose spend or order count no longer qualifies should move to a lower tier or lose their tier. Lower-tier rewards aren't issued.

  4. If you chose specific customers, you can select Include customers with a manually assigned tier. Their tier is then worked out again from their progress, even if you set it with Assign VIP Tiers in Bulk, and it updates automatically from then on.

  5. Click Recalculate, or Recalculate All when no filters are set. Recalculate All never changes a Manual tier.

Customers who move up to a new tier may get your VIP Tier Achieved email, if it's turned on. The operation needs an active VIP program. If yours is off, the window shows Activate your VIP program to recalculate tiers with a Go to VIP program button. Activating the program recalculates every customer's tier automatically.


Export points earned and download the rewards report

Two operations create a CSV file you can open in a spreadsheet.

  • Export Points Earned By Customer totals each customer's earned points for a date range. It's useful for deciding VIP tiers from a past period, such as last year's activity. The file lists each customer's email, name, customer ID and points earned.

  • Download Rewards Report lists all customer rewards: active, redeemed and expired.

In either window, choose an address under Email, then click Export or Download. When the file is ready, that address gets an email with a link to More → Exports, where you download it.

The Email list shows the addresses in Allowed Email Addresses For Notifications, under Email Notifications in More → Advanced Settings. Only the store owner can add addresses there.


Email customers about unredeemed rewards

Send a one-time reminder to customers who have points to spend. It goes to every customer with a points balance above 0 who receives loyalty emails, and skips anyone already reminded today.

Before you send, check that:

  • Klaviyo or Omnisend is connected in More → App Integrations. Until it is, Configure stays grayed out. To set one up, see How to Integrate Klaviyo with Appstle Loyalty or How to Integrate Omnisend with Appstle Loyalty & Rewards.

  • A Klaviyo flow or Omnisend automation is triggered by the Monthly reward reminder event from Appstle Loyalty event. The app sends that event for each customer, and your flow sends the email.

  • The Monthly Reward Reminder email is turned on in More → Email Templates.

  • Loyalty is turned on in the Loyalty on your store card on the Design page.

  1. Click Configure on Email Customers About Unredeemed Rewards.

  2. Click Send to confirm.


Issue rewards to customers

Give one reward to many customers at once. You choose whether it costs them points.

  1. Click Configure on Issue Rewards to Customers. It opens on its own page.

  2. Under Select Customer type, choose All Customers or Specific Customers. For specific customers, choose a VIP tier, or enter tags, customer IDs or emails.

  3. Select Deduct points from customer for reward? if the reward should cost points. Only customers with more points than the reward costs get it.

  4. Under Select Reward, choose one reward. For a dynamic discount, enter the points. For a free product, select the product.

  5. Click Save in the bar at the top of the page.

Customers get your Reward Available Reminder email about the reward, if it's turned on.


Combine customer accounts

Merge the loyalty points, rewards and history of one account into another. This helps with duplicate accounts.

  1. Click Configure on Combine Customer Accounts.

  2. In Email/Customer ID of the Customer receiving the merge, enter the account to keep. In Email/Customer ID of the Customer being Merged, enter the account to merge in.

  3. Click Preview merge. The window shows both accounts and the combined balance.

  4. Check the preview, then click Merge. The Merge button stays grayed out until you preview.

Points, rewards, referrals and activity history move to the account you keep, and the other loyalty account is removed. Orders, addresses and other customer details aren't merged here.

If you're merging the two customers in Shopify too, do that first: it usually combines their loyalty points as well. Then check the kept customer's points. If they didn't move, merge here using the removed account's customer ID, and keep the same customer in both places.


Delete customers from the program

Permanently remove customers from your loyalty program, with their points, points history, rewards and referrals. Their Shopify customer records stay.

  1. Click Configure on Delete Customers from Program.

  2. Enter customer IDs, or upload a CSV. If you upload a CSV, the IDs you typed are ignored.

  3. Click Confirm.

A deleted customer who places another order can join the program again. To keep someone out for good, open them in Customers and use Exclude from program instead.


Troubleshooting

  • Configure is grayed out. Another operation is running, so wait until the progress badge at the top disappears. On Email Customers About Unredeemed Rewards, it also stays grayed out until Klaviyo or Omnisend is connected.

  • Import orders is grayed out. Turn on the app embed with Activate app embed in the window's banner, then try again.

  • An imported order earned no points. Open the customer and check Activity Logs. The row says why, for example that the order was fully refunded or had already earned points.

  • A VIP operation won't start. For Assign VIP Tiers in Bulk, choose a tier and at least one customer filter. For Recalculate VIP Tiers, activate your VIP program first.

  • The Email list in an export window is empty. Exports go only to addresses in Allowed Email Addresses For Notifications (More → Advanced Settings, under Email Notifications). Ask the store owner to add yours.

  • An import shows Stopped early. Run it again with the same settings. Orders that already earned points are skipped, so no one earns twice.

  • A customer's tier didn't change after a recalculation. Their tier is probably set to Manual. Recalculate them as a specific customer with Include customers with a manually assigned tier selected. The customer's Activity Logs say why a tier didn't change.

  • Customers didn't get the reward reminder. Check that your Klaviyo or Omnisend flow uses the Monthly reward reminder event from Appstle Loyalty event and is live, and that the Monthly Reward Reminder email and loyalty on your store are both turned on. Customers with 0 points, or who were already reminded that day, are skipped.


FAQs

How do I know an operation finished?

The progress badge at the top of Bulk Operations disappears. For an import, the Previous imports list also shows the status.

Do customers get emails when I import past orders?

Yes, if your Point Earn or Credits Earn email is turned on, because each imported order is handled like a new one. To avoid it, turn those emails off in More → Email Templates until the import finishes.

Does deleting a customer from the program delete them from Shopify?

No. It removes their loyalty data only.

Can I run two operations at the same time?

No. Start the next one when the badge disappears.

Where do I give or remove points for one customer?

Open the customer in Customers, click Manage customer, then Give Points/Credits or Remove Points/Credits. See Give or remove points and store credit by hand.

Did this answer your question?