Home Common questions & answers

Common questions & answers

By Ashley
10 articles

Importing stamps via CSV

There’s times when you are going to want to adjust customers stamp balance in bulk. One of the most common reasons is when you first install the app and wish to move your rewards program from another platform and wish to bring customers “points balance” over into our loyalty program. You might also wish to offer your entire customer base or a selection of them “bonus points” for whatever reason like Christmas or maybe a customer service good will gesture. Whatever the reason the process of uploading stamp balance to your customers is easy and should only take you less than few minutes depending on your customer list size. You can choose to update the stamp balance of all your customers on your store, not just the ones that are members of the program but also guests as well. This means once they sign up with you, they will already have some points in their account… cool right? If you do want to just update a couple of customers, you can do so easily inside the app itself by heading to the customer list and selecting the customer you wish to change. If you are looking to port over your customer balance from another app or program that uses points then please read Switching from another loyalty program first. On this page - Important notes before the upload - Creating your own file - Using the Appy Stamp Admin Export - Using the import feature Important notes before the upload When using the upload to amend their stamps, we will set it to the new value in the CSV. So if you wish to add stamps to their account, you need to add it onto their current balance from within the CSV. We will then log the difference on their account to bring them to their new balance, this is for both additions and deductions. For example If a customer has 10 stamps and you export the CSV, then set their stamps to 15, when you upload it we will add 5 stamps, bringing their total balance to 15. You will see the difference in their ledger history. Creating your own file If you have a CSV with your customers already, then it is super easy to update your current CSV so that we can read it correctly. As a minimum we only need two columns to work: Email, Phone number or Customer ID and Stamp Balance. With these two columns we will then update their balance to be the new stamp balance in the sheet. Please note column names need to be exact – case sensitive and spaces. - Id – (The customer ID from Shopify) - Email - Phone - Stamp Balance Using the export feature Once you’ve installed the app and we have imported your customers, you can also download your customers from our app into a CSV. This is useful because it is exported in the same format we need for the import. If you head to Customers from within the app admin and then click on Export customers this will bring up the modal to choose what you wish to export. Select “all customers” and press export. We will then export your customers in the background and send an email to your main Shopify email address when the export is ready. When you open this up you will get the different columns of data we store for that customers. This will export their current balance if any, so you can amend then Stamp Balance column and export it again as a CSV and then upload this file. Using the import feature One of the easiest ways to get started is by exporting your customers from our app or downloading the template we have set up as an example. You can download the sample here. Once you have your CSV file and you’ve updated it how you wish, head to Customers and then click on Adjust customers, then on Adjust stamps. This will open our modal that you can then upload your CSV and choose an optional comment that your customers can see. Once your CSV is added, you will be able to click on Update Balance, we will then send the job to our system and notify you by email once it is complete. Doing this on a live program can make customer balances inaccurate as we have a number of systems in place to keep their balance tied to the activities they earn. That’s it, you are done!

Last updated on May 18, 2026

Removing a customer from the program

Sometimes you may need to remove customers from your loyalty program. This could be because they are spam accounts, wholesale accounts or other reasons that you’d not want them to be able to get the offers you have for being a member of the program. Removing a customer from the program You can remove a customer by first going to the customer list in the app admin. From here you will be able to search the customer you wish to remove. 1. From the customer details page, you can click on the Remove from program button under their name 2. When you click on remove, a popup dialog will ask you to confirm you wish to remove them. 3. Once confirmed, they will be marked as removed. Once a customer has been removed they will no longer be able to access their loyalty program account from within the widget that is shown on your store. They will also be unable to earn stamps from activities such as orders or social media actions and integrations and they will be unable to redeem any rewards. Note: Customers who are removed from the program will still be able to see the “non logged in” widget as at this point in time, we don’t have their customer information to check if they are eligble or not. Re-enabling a customer to join the program If you change your mind, you are able to enable a customers entry into the program again by repeating the same steps above. A customer that has been removed, will have the option to Enlist to program Clicking on this button, will like before, open a dialog to confirm you wish to add them to the program. Once you’ve clicked on Enlist they will be back in the program and will be able to earn stamps, redeem for rewards and access their member portal from inside the widget on your store.

Last updated on Apr 27, 2025

Admin and widget caching

Caching is an important step in most internet based systems or websites and is used to reduce the amount of data that is needed to be “re-downloaded” for a page or system to run. We use caching in various placing in our internal systems, the customer Widget on your store and inside the admin where you tweak your program. Caching on the widget For the widget, we cache some information for up to 15 minutes such as activity data for a customer – so they might not always see their latest activity information if they’ve just placed an order for example. The same is said about a customers VIP progress. We also cache the Earn & Redeem items in the widget but this happens on each page load when they access those parts of the app. When the reload the page or move to another page, we will get the updated version of those areas again when they view them. Any widget styles and text customisations are also cached for up to 15 minutes. So if you make a change to the colour of your widget or the text in a button, it might not be reflected straight away. What’s not cached We currently do not cache if your program is live or not, this means that when your turn of your program it should hide the widget right away but sometimes the browser might cache some data that causes it still to be shown for sometime after. We do not fully cache at the moment, the stamp data a customer has – this means on every page load if they open up the widget we will grab their stamp balance again. In times of high load on our server, we may cache some of this information however. Caching in the admin Currently we cache the settings information inside the admin for 5 minutes, or when you make a change. Caching in the backend systems We also cache other things inside the admin such as the email previews and the customer POS rewards that they can be given. Customer POS data is cached every hour, so they might not always have the most up to date stamp information in their account. Important: although you won’t see the changes right away any changes you make will take effect immediately. If you change how many stamps are on a card, or how many stamps someone earns on an activity – you might not see it be reflected in the widget but it will take affect right away.

Last updated on Apr 27, 2025

Subscription order activities explained

When you have a subscription integration connected to your loyalty program, you will be given the option to set up a reward activity for those who place subscription orders specifically. This allows you to run promotions like double stamps, for subscription customers or only offer stamps to customers that have subscribed, and normal one-time orders will not get stamps for their purchases. How it works Subscription only activity If you run the subscription order activity on its own, so that only subscription purchases can collect stamps, then we will be able to assign the stamps as needed without any changes. Normal order activity and subscription order activity When you decide to offer stamps for both types of orders one-time and subscription we have to do some extra work in the background. New orders (first time subscriptions) When a new order first comes in, Shopify treats it as a regular order in the background. So we have to mark it as a normal order – reward the customer with the stamps set in the normal order activity. Then we do some magic in the background, to work out if this order is a normal order or a first time subscription order. If we notice that the order should be a subscription one, then we replace the normal order for the subscription one and if there is a stamp amount difference, we will change this and update the customers total stamps. The customer will likely not notice anything on their side, as these checks usually happen within a 10 – 20 seconds of each other. The caveat. The one thing we don’t change at the moment is the email notification that goes out. So if a customer does order a first time subscription order, they will get the email for the regular order activity and how many stamps are awarded for that. This is because, we queue our emails at the point when the activity is created. So when a customer orders and you have notifications turned on, we will queue that email with the current data we have at the time for that order. When the order is then updated, because we “swap” the activity, we decide not to send out another email for the new sub order activity being rewarded as this might confuse customers to get to emails within a minute of each other. We are working on a better flow for this, and will likely delay order emails going out for a few minutes in the future to be able to make sure. This caveat is because Shopify decide to mark the first order with no data to suggest it is actually a first time subscription order. We rely on the subscription apps to send over additional information but this usually happens about 20 seconds after the order.

Last updated on Apr 27, 2025

Using template variables

In parts of the Appy Stamped app, we allow the use of template variables so that you can dynamically pull through some of your loyalty data into places like the customer widget, beacons and the notifications we send out for you, like when a customer earns stamps. All variables use the moustache syntax {{}} so would look like {{stampBalance}} when inputted into a field. Below is a list of currently available template variables: - stampsBrandingPlural – the plural name for your stamp i.e Stamps - stampsBrandingSingular – the single name for your stamp i.e Stamp - stampCardValue – amount of stamps per card - storeCurrency – the ISO4217 value of the currency selected i.e USD / GBP - storeCurrencySymbol – the symbol for the currency i.e. $/£ Email Specific Variables These variables are only available in the certain email templates that we sent out for certain events to your customers. Reward Redeemed - reward – the reward name that was redeemed Stamps Earned - stampsEarned – the amount of stamps earned - activityName – the name of the activity Why can’t I find the template variable I want to use We only expose certain variables for emails and other places in the app such as the widget that are likely to be used. If you require a different piece of data which we store for an email or you want to use it in the widget, then get in touch and we can take a look for you. Can I edit the HTML of emails? We currently don’t offer the ability to edit the HTML of our emails. You can replace the text in most places, which satisfies 99% of our merchants. If there is something missing from one of our templates, please get in touch as we can discuss what we can do. How do I know what variables can be used? When you edit a notification or beacon, will we show which template variables can be used on that page as well. For example, here is our beacon edit page. This way you should have most of the common variables needed for each of the different parts of the app you’re tryi

Last updated on May 24, 2026

Widget not showing on my website

After you’ve finished the onboarding process we will give you an option to enable the program and widget at the same time. If however, you decide not to you might need to enable it manually once you are ready. Enabling our site widget is done within the Shopify theme customiser as we use a Shopify App Embed to put our widget on your site. We do this because it is highly compatible with most themes as it does not need any theme code changes. Check your program is enabled. The most common reason the widget is not displaying is because the stamp program from inside the app is deactivated. Head to our app on your store and go into Stamp Program and then check that your stamp program is active. It is the first setting on this page and will tell you the current status. Check the theme customiser setting Log into your Shopify admin and head to Online Store. From here you want to click on Customise on the main theme that is currently live. From there you will be taken to the Shopify theme editor, and you can select the App Embed blocks which is found on the left hand side of the page. From here you should see our embed and you might see more if you have other apps installed that also use them. Make sure that our embed block is marked as active. You can see from our image above what that state looks like. It is a toggle, so you might just need to click it and turn it on. Last but importantly. If you enable our embed block from it being off, you need to remember to save the theme edits at the top of the page. That’s it you should be done and the widget should show up on your store. Check for any javascript errors on your website If you have multiple apps installed, there is likely to be a lot of different code that is being run. If an error happens with any code, sometimes it can stop the execution of more code and this can sometimes affect the loading on our widget and other functions on your site. To check for errors, you can open up your browsers developer tools, usually by pressing F12 and then goiing to console on the tab in the tool window. The dev tool window will show you any errors and other information that the browser has. If you see any red errors in here, then you can send them to your developer to have a look. If you are unsure, then you can also get in touch with us. We won’t be able to make any changes on your site, but our team can help you to try and diagnose the issue.

Last updated on May 17, 2026