Installation & Setup¶
Requirements¶
Before installing, make sure:
- Gift cards are available in your Shopify store. If Shopify admin has no Gift cards section, or Shopify says gift cards aren't activated, see Gift cards are not activated below.
- Your store currency is set. Gift Card Hero issues gift cards in your store currency by default. If you sell in several currencies through Shopify Markets, you can also issue cards in the currencies your markets enable.
- You can install apps. You need to be the store owner or a staff member allowed to install apps.
Installing the app¶
- Find Gift Card Hero in the Shopify App Store.
- Click Add app.
- Review the permissions the app requests and click Install app.
Permissions explained¶
Gift Card Hero asks Shopify for these permissions:
| Permission | Why it's needed |
|---|---|
| Gift cards, gift card transactions and adjustments (read and write) | Create gift cards, read balances and history, and top up or adjust balances |
| Orders (write) and all order history (read) | Issue cards for paid orders, process refunds, and build analytics for the whole life of your store |
| Customers (read and write) | Attach gift cards to customer accounts |
| Products, product publications and inventory (read and write) | Create and manage your gift card products |
| Draft orders | Reload balances and issue larger amounts |
| Themes, files and content (write) | Add the app embed and the gift card page to your theme |
| Markets (read) and locations (read) | Issue cards in market currencies and work with your POS locations |
| Cart transforms, payment customizations and price rules | Custom-amount cards and payment rules |
| Fulfillment orders | Send gift cards when their orders are fulfilled |
| Storefront (checkouts and customers) | Customer-facing features such as the balance check |
If the app later needs a permission it doesn't have yet, it shows a banner with a Give the app additional scope button on the page that needs it (for example, Analytics asks for access to all order history). Click it and approve the request in Shopify.
Choose a plan¶
The first time you open the app, you are asked to choose a plan. Development stores skip this step.

- PRO is a flat monthly fee. It adds POS tools, unused balance reminders and the API for developers.
- Free to install (Pay as you go) charges 2% of the total value of all gift cards issued in the month, with a monthly minimum of $9.99 and a maximum of $49.99.
Both plans start with a 7-day free trial, and you can cancel any time. You approve the subscription in Shopify, then return to the app. Shopify Plus stores pay a different PRO price and can't use Free to install. See billing for details, and to change plans later, use Upgrade plan on the home page (shown on the Pay as you go plan) or contact support.
Complete the setup wizard¶
After you choose a plan, a short wizard sets up the essentials. It takes about 2 minutes. Click Get started on the welcome screen to begin.

Click Skip setup at any time to leave the wizard and configure things later from the home page. Use Back and Continue to move between steps.
Step 1 — Product¶
Choose or create the gift card product that customers buy.
- If your store already has gift card products, pick one from Existing gift card products. Its current denominations are shown as badges.
- If not, the wizard offers to create one. Enter a Product title and Description, then add Denominations. Each denomination has a Label and a Price (for example $25, $50, $100). Click + Add denomination for more.
- Pick an Initial status: Draft (publish when ready), Active (available immediately) or Unlisted (published but hidden from the storefront).

Gift cards are not activated¶
If Shopify hasn't activated gift cards in your store, the wizard shows One more click in Shopify. Click Open Shopify gift cards, then click Add gift card product in Shopify. When you come back to the tab, the wizard continues automatically.
Step 2 — Designs¶
Select the card designs your customers will see. Tick the designs you want, or drag in your own image to add a custom design. The counter shows how many designs are selected.

Step 3 — Features¶
Switch on the features that fit your store:
- Custom amount — customers choose any gift card value.
- Scheduled delivery — customers pick when the card is sent (recommended).
- Video messages — customers attach a short video.
- Custom images — customers upload their own image.
You can change all of these later in the E-Gift cards tab. See eGift Cards.

Step 4 — Theme¶
Gift Card Hero shows its widgets on your storefront through an app embed in your theme. This step turns it on.
- Click Open theme editor. Shopify opens the theme editor in a new tab.
- Find App embeds in the left sidebar.
- Switch Gift Card Hero on.
- Click Save in the top right.
- Return to the wizard tab. It detects the change within seconds and shows "Theme extension is active."
If nothing is detected after 3 minutes, make sure you saved the theme editor, then click Check again.
Click Complete setup to finish. The button stays disabled until the app embed is on. If you'd rather do it later, use Skip setup and switch the embed on from the home page.

After the wizard¶
You land on the home page. Your gift card product is set up, and customers can buy gift cards once the product is published and the app embed is on.
The Setup guide on the home page lists what is left: create your first gift card, enable the balance check widget, configure the email template, set up physical gift cards and enable balance reminders. Each task is ticked off automatically. If you use Shopify POS, see POS Integration.

To try the whole flow without paying, see How to Test a Gift Card. To send a card yourself, see the Quick Start.
Check the app embed later¶
The App Blocks Status card on the home page shows, theme by theme, whether the Gift Card Hero app embed is Enabled or Disabled.
- Pick a theme from the theme menu (your live theme is labelled Live).
- Click Activate app embed (or Deactivate app embed). Shopify's theme editor opens.
- Switch the embed on or off, then click Save.
When the embed is on you can also click See it on your storefront to preview the gift card product in that theme.

Uninstalling¶
If you uninstall Gift Card Hero:
- All gift cards you issued stay valid. They are native Shopify gift cards, and customers can still use them at checkout.
- Your subscription is cancelled.
- Gift Card Hero's widgets disappear from your storefront and the app stops sending gift card emails and reminders.
- If you reinstall, you go through the plan choice and the setup wizard again, and the home page tips and banners you closed appear again.
Your data
Gift Card Hero follows Shopify's data-erasure requests: after an uninstall, Shopify tells the app when to delete your store's data.