Loyalty Gifts
This article explains what you can see and manage in commercetools for loyalty gifts. A loyal customer receives an email with a gift link. They pick one eligible free product from the configured pool, and that product is added to their upcoming delivery. The commercetools product selection with key loyalty-gifts is the pool of free products they can pick from.
This is not a Cart Threshold Bar gift. Threshold gifts are cart discounts. Loyalty gifts are products assigned to a product selection.
The picture next to the heading on the gift page is set in Hygraph. See Loyalty Gifts in Hygraph. WHICH products are offered is set in commercetools, that is the configuration described in this article.
Product selection
The shop looks up gifts from a specific product selection whose key is exactly loyalty-gifts. Do not rename or delete that selection. A selection with another key is ignored. To open it, in commercetools hover over Products in the left menu bar and select Product selections. Search for loyalty-gifts.
In the list of Products, you can filter products on Product Selection "Loyalty Gift":
The shop reads up to 500 products from this selection. Products beyond that are not offered. You do not attach this selection to a store. Which shops can offer a gift is decided by the store’s own product selection, see Store assortment.
Assigning a gift
A product is a loyalty gift when it is assigned to loyalty-gifts. Assign it from the product, on the Product Selections tab, with + Assign variants to a product selection. See Create a Product.
The assignment logic is:
- All variants — every SKU of the product is offered as its own gift.
- Only the following variants — only the SKUs you pick are offered.
Each included SKU shows as a separate card on the gift page. The product must be Published, and it must already be a normal shop product (it already has Hygraph content). Example: a catalogue-only product that is not on the shop does not appear on the gift page.
To stop offering a product, remove it from loyalty-gifts and publish the product. Customers who already confirmed a gift keep it on that delivery.
Store assortment
If the shop’s store has a product selection, a gift is only offered when that same product and SKU are also in the store’s selection. A gift that is in loyalty-gifts but not sold in that shop does not show.
Cost price
Fill Cost Price – Purchase Price (product-cost-price) on every gift variant. See Create a Product.
The shop uses this when the customer already received every gift in the last 12 months. In that case already received products are included again, and it offers the variant with the lowest cost price, still limited to the store’s assortment. Without a cost price on any of those variants, the page has no gift to offer.
Who can pick a gift
The gift link in the email points at the upcoming delivery cart in commercetools. The shop only offers gifts when that cart is still Active and belongs to a customer.
- One gift per delivery. After a gift is confirmed, the same link shows that a gift is already added. A second gift cannot be added.
- The package is already on its way. Once the cart is Ordered, the link can no longer add a gift.
- The link is no longer valid. A cart that is not active, has no customer, or is not the upcoming delivery cart from the email cannot be used.
The shop also hides gifts the customer already received. It looks at orders created for that customer in the last 12 months, including cancelled orders, and skips any product (by product key) that already appears on those orders. Receiving one variant of a product hides every variant of that product. When every gift was already received, already received products are included again and the lowest cost-price fallback above applies.
The gift on a cart or order
The chosen gift is a normal line item with quantity 1 and a price of 0. Its line item key is loyalty-gift. Look for that key if you need to see whether a delivery already has a gift.
Do not add this line by hand. The shop adds it when the customer confirms their choice.
Ask the development team
Ask the development team, via #help-commercetools-hygraph, for:
- Creating the
loyalty-giftsproduct selection on a tenant that does not have it - Changing the gift link, who receives the email, or which carts the page accepts
- Changing the 12-month rule or the cost-price fallback
- Starting loyalty gifts on another brand