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
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 denomination | Typical use |
|---|---|
| KSh 500 | Small treat or thank-you |
| KSh 1,000 | Standard gift |
| KSh 2,500 | Premium gift |
| KSh 5,000 | Corporate gifting |
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.
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.