Skip to content

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

  1. Find Gift Card Hero in the Shopify App Store.
  2. Click Add app.
  3. 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.

Select a subscription plan

  • 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.

The welcome screen of the setup wizard

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).

Step 1: the gift card product

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 2: card designs

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 3: features

Step 4 — Theme

Gift Card Hero shows its widgets on your storefront through an app embed in your theme. This step turns it on.

  1. Click Open theme editor. Shopify opens the theme editor in a new tab.
  2. Find App embeds in the left sidebar.
  3. Switch Gift Card Hero on.
  4. Click Save in the top right.
  5. 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.

Step 4: enable the app embed in your theme

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.

The setup guide on the home page

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.

  1. Pick a theme from the theme menu (your live theme is labelled Live).
  2. Click Activate app embed (or Deactivate app embed). Shopify's theme editor opens.
  3. 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.

App Blocks Status on the home page

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.