HomeProductsGift Cards
all
4 min read

Gift Cards

Gift cards are a built-in Medusa product type. They work like store credit: a customer purchases a gift card, receives a unique code by email, and redeems it at checkout. The discount is applied automatically — no coupon setup required.

How gift cards work

1
You create a gift card product
Set denominations (values) and publish it. It appears on your storefront like any other product.
2
Customer buys a gift card
At checkout the system creates a unique redemption code and emails it to the recipient.
3
Recipient uses the code
At checkout, the customer enters the code in the gift card field. The balance is applied instantly.
4
Partial redemption works
If the cart total is less than the gift card value, the remaining balance is preserved for future orders.

Creating a gift card

Go to Products → Gift Cards and click Create gift card.

Denominations

Each denomination becomes a variant. Add as many as you like:

Example denominationTypical use
KSh 500Small treat or thank-you
KSh 1,000Standard gift
KSh 2,500Premium gift
KSh 5,000Corporate gifting
💡Tip

You can add custom denominations at any time. Deactivate a denomination (rather than deleting it) to preserve its history in existing orders.

Thumbnail and description

Upload a gift card design image and write a description — this is what appears on the product page. Keep it short and inviting: "Send a gift they'll love. Redeemable on anything in the store."

No inventory tracking

Gift cards never require inventory management. Medusa does not track stock for gift cards — they are always available.


Managing issued gift cards

Go to Products → Gift Cards and select the Issued Gift Cards tab to see every code that has been created, along with:

  • The original order it came from
  • The starting balance
  • The remaining balance
  • Whether it has been used or is still active

Manually creating a gift card code

You can issue gift card codes without a purchase — useful for:

  • Goodwill gestures after a bad experience
  • Employee benefits
  • Contest prizes

Click + Create manually, enter the value, and optionally set an expiry date. The code is generated immediately and you can copy it to send directly.

Disabling a gift card code

To prevent a specific code from being used (e.g. suspected fraud), open the issued gift card and toggle it to Disabled. The balance is preserved in case you re-enable it later.


Gift cards and promotions

Gift cards and promotions stack by default. A customer can apply both a discount code and a gift card in the same checkout. If you want to prevent this, configure your promotions with the Cannot be combined restriction.

⚠️Warning

Refunding an order paid with a gift card: the refund goes back to the gift card balance, not to the original payment method. Make sure your customers know this — it prevents disputes.

Related Articles
Gift Cards — Sokobuni Learn