For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gift card

Customize the gift card page image and learn about gift card template limitations and troubleshooting.

Theme Editor → Theme settings → Gift card

The gift card page is shown to the recipient after a gift card is purchased. It automatically generates a unique code, a QR code for easy redemption, and supports adding the card to Apple Wallet.

Shopify gift cards guide


Customize the image

Go to Theme settings → Gift card and upload a custom image to replace the default gift card design.

Custom image — recommended size: 1024 × 1024 px.


Important limitation

The gift card page uses a standalone Liquid template (gift_card.liquid) — not an OS 2.0 JSON template.

Because of this:

  • You cannot edit this page using blocks and sections in the Theme Editor

  • Any structural changes beyond replacing the image require editing gift_card.liquid directly in the code editor

question

Troubleshooting

Gift card page appears blank

If the page loads but shows no content, it's caused by a conflict with the theme's fade-in animation. The gift_card.liquid template uses {% layout none %}, so standard scripts aren't loaded — leaving the content hidden.

How to fix it: You can easily resolve this by adding one line of code to the template.

  1. Go to Shopify Admin → Online Store → Themes.

  2. Click the "..." button next to your theme and select Edit code.

  3. Open the templates/gift_card.liquid file.

  4. Scroll to the very bottom and find the closing </body> tag.

  5. Paste the following code exactly before the </body> tag: {{ 'global.js' | asset_url | script_tag }}

  6. Click Save.

If you are not comfortable editing theme files, please contact our support team and we will resolve it for you!

Last updated

Was this helpful?