Home Common questions & answers

Common questions & answers

By Ashley
6 articles

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 Jun 15, 2026

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 Jun 15, 2026

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 Jun 15, 2026