4. Widget Not Appearing on My Store

Diagnose and fix the most common reasons your Giftnote gift message widget isn't showing on your Shopify store, starting from the Online store widgets status in the app.

Written By Giftnote Team

Last updated About 1 hour ago

If your gift message widget isn't showing up on your store despite installing Giftnote, you're not alone — this is the most common setup issue and is almost always caused by one of a handful of things. This guide walks you through each cause so you can diagnose and fix it yourself.

Start with the Online store widgets status

Open the Giftnote app and go to Settings → Overview. The Online store widgets card lists each Giftnote widget on your theme and whether it's on: the Control Panel (the Giftnote Control Panel app embed, on every page), then each widget grouped under Gift Orders, Gift Cards and Multi Gift, such as the Gift Orders Message on your product page or cart and the Gift Cards Check balance. Each one shows as Active or Inactive. If the Control Panel shows Inactive, the app embed is off and nothing below it will show: go straight to cause 1. To fix a widget marked Inactive, select Edit on theme, or Add to theme if you haven't added it yet.

Settings → Overview in the Giftnote app: the Online store widgets card, showing the Control Panel and each Gift Orders and Gift Cards widget as Active or Inactive, with Edit on theme, Add to theme and Help buttons

This card only reflects your published theme. Changes on a draft theme appear there once you publish it.

Most common causes

These are listed in order of how frequently they occur. Start at #1 — it resolves the issue for most merchants.

  1. The Giftnote app embed isn't enabled — the widget won't render anywhere on your store until this is toggled on.
  2. You recently published a new theme — publishing a new Shopify theme resets all app embed settings, including Giftnote.
  3. Your cart drawer requires manual code — most cart drawers don't support drag-and-drop widget placement.
  4. Another app is conflicting with the widget — apps like Route, Skio, Printful, Govalo or GiftShip can interfere with widget rendering.
  5. The widget block isn't added to your product page template — on Online Store 2.0 themes, the widget block must be placed in the correct template section.
  6. A Giftnote setting is hiding it on purpose — the product is in Hidden products, the shopper's country is in Blocked markets, or the design hides the widget for B2B customers.

1. Enable the Giftnote app embed

This is the most common fix. The Giftnote app embed is a master switch — if it's off, the gift message widget won't appear on any page of your store.

  1. Open your Shopify admin and go to Online Store → Themes (or select Edit on theme next to Control Panel on Settings → Overview in the Giftnote app).
  2. Click Customize on your live theme.
  3. Click the App embeds icon in the left sidebar. It looks like a puzzle piece or a grid, near the top of the sidebar.
  4. Find Giftnote Control Panel in the list and toggle it on. If Giftnote doesn't appear in the App embeds list, the app may not be fully installed. Go to Apps in your Shopify admin and confirm Giftnote is listed as an installed app. If it's missing, reinstall it from the Shopify App Store.
  5. Click Save in the top-right corner of the theme editor.

Your gift message widget should appear on your store within 30 seconds. Open a product page in a new browser tab to confirm. On Settings → Overview, the Control Panel should now show Active.

2. Re-enable the Giftnote app embed after publishing a new theme

Every time you publish a new Shopify theme, all app embed settings reset to their defaults. This means the Giftnote app embed gets turned off — even if it was on in your previous theme. This catches a lot of merchants off guard, especially after seasonal theme updates or developer handoffs.

  1. Go to Online Store → Themes → Customize on your currently published theme.
  2. Click the App embeds icon in the left sidebar.
  3. Toggle Giftnote Control Panel back on.
  4. Click Save.

If you had custom CSS styling on your previous theme's gift message widget, you'll need to re-enter it. Open the Giftnote Control Panel section within App embeds and paste your CSS into the Modal Styling (CSS) field.

Tip: Before publishing a new theme in the future, open the unpublished theme in the theme editor first and enable the Giftnote app embed there. That way it's already active the moment the theme goes live.

3. Add the gift message widget to your cart drawer

Cart drawers (also called slide-out carts or side carts) on most themes require a manual code insertion to display the gift message widget. This is different from the product page or cart page, where the widget can be added with drag-and-drop. On Settings → Gift Orders, the Theme card's Message (Cart) row covers the cart page and cart drawer.

If your cart drawer is built into your theme: This typically requires a small Liquid code edit to your theme files. Paste the Giftnote button snippet into your cart-drawer.liquid file or equivalent:

<template id="__NAME_OF_BUTTON__">
  <style> /* ADD CSS HERE */ </style>
</template>
<giftnote-button
  data-styles="__NAME_OF_BUTTON__"
  data-add="Add a gift message"
  data-edit="Edit gift message"
></giftnote-button>

Change __NAME_OF_BUTTON__ to any name you like (use the same name in both places). The Giftnote app embed must be on (see cause 1) for the button to open the popup. See "3. Add Gift Message Widget" for more on the snippet.

If you'd rather not edit code and you're on a paid plan (Core or Professional), you can ask us to add the widget to your cart drawer on a staging theme so you can preview it before going live: chat with us using the chat button in the help centre or in the app, or email support@giftnote.com, with your store URL and theme name, and we'll send a Shopify collaborator request.

Adding the widget to the cart drawer as well as the product page gives customers another chance to add a gift message. It's worth doing.

If you're using Rebuy Smart Cart: First try Rebuy's own Giftnote module. In Rebuy, go to Smart Cart, open your active Smart Cart, scroll to the Apps section, configure Giftnote (set both button labels), toggle it on and save. See "Rebuy integration" for the full steps.

If the module doesn't suit your cart, use a Custom HTML widget instead:

  1. Open your Rebuy admin and go to Smart Cart › Widgets.
  2. Add a Custom HTML widget at your desired cart position.
  3. Paste the <giftnote-button> snippet shown above into the widget content field.
  4. Save and publish your Smart Cart.

This works whether or not you connect a Rebuy API key in Settings → Integrations → Rebuy. Make sure the Giftnote app embed is enabled (see cause 1).

If you're using another cart app (Slide Cart, CartHook):

  1. Confirm the Giftnote app embed is enabled (see cause 1).
  2. Check whether your cart app supports app blocks or custom HTML. If it does, add the Giftnote widget inside the cart app's configuration.
  3. If it doesn't, chat with us using the chat button in the help centre or in the app. On a paid plan (Core or Professional), we can handle the manual integration for you.

4. Resolve conflicts with other apps

Certain Shopify apps can interfere with the gift message widget rendering. The most common culprits are:

  • Route — shipping protection widget can overlap or block the Giftnote widget
  • Skio — subscription logic can interfere with widget display on subscription product pages
  • Printful — fulfilment app can conflict with order attribute handling
  • Govalo or Rise.ai — competing gift card apps that display their own widgets; having both active simultaneously can cause duplicate or missing widgets
  • GiftShip — has its own gift message system that can block Giftnote on the cart page
  • Broadcast theme's built-in "Gift Note" field — this native theme feature conflicts directly with the Giftnote app

How to diagnose an app conflict:

  1. Open your store in a private/incognito browser window. This eliminates browser extension interference.
  2. Check if the gift message widget appears on a product page. If it appears on the product page but not in the cart drawer or checkout, the conflict is likely specific to one surface — note which one.
  3. Temporarily disable other apps one at a time. Go to Online Store → Themes → Customize → App embeds and toggle off other apps one by one, saving and checking your store each time. When the gift message widget reappears, you've found the conflicting app.
  4. Re-enable the conflicting app and chat with us. Send us your store URL, the name of the conflicting app, and where the widget isn't appearing. We'll find a fix that lets both apps work together.

If you're using the Broadcast theme: The Broadcast theme has a built-in "Gift Note" field that conflicts with Giftnote. You'll need to hide the native field in your theme settings or template code. On a paid plan (Core or Professional), we can handle this for you: chat with us, and we'll send a Shopify collaborator request.

Migrating from Govalo or Rise.ai? Deactivate or uninstall the competing app before activating the Giftnote widget on your live theme. Running both simultaneously causes duplicate gift card issuance and widget display conflicts.

5. Add the widget block to your product page template (Online Store 2.0)

On Online Store 2.0 themes (most modern Shopify themes), the gift message widget needs to be added as an app block on the product page template — and the Giftnote app embed needs to be on as well.

  1. Go to Online Store → Themes → Customize. From the Giftnote app, Edit on theme (or Add to theme) next to Message (Product page) on Settings → Gift Orders also opens your theme editor.
  2. Navigate to a product page using the page selector at the top of the editor. Click the dropdown that says "Home page" and select Products → Default product.
  3. Click Add block in the product page template.
  4. Search for "giftnote", open the Apps tab and select the Gift Order Message block. If Giftnote doesn't appear when you search, confirm that the Giftnote app embed is toggled on (see cause 1).
  5. Drag the block to your preferred position — most merchants place it directly below the Add to Cart button.
  6. Click Save.

Multiple product templates? If you use different templates for different product types, you'll need to add the Giftnote widget block to each template where you want the gift message widget to appear. Repeat steps 2–6 for each template.

6. Check Giftnote settings that hide the widget

Giftnote can hide the gift message option on purpose. If the widget shows on some products or for some shoppers but not others, check these:

  • Hidden products — Settings → Gift Orders → Advanced → Surcharge & visibility. Products listed here don't show the gift-message option on the product page.
  • Blocked markets — same card. Shoppers in the countries listed don't see the gift-message option on the product page. Test with a shopper location outside those countries.
  • Hide for B2B customers — Settings → Gift Orders → Widgets → open your design → Display card. When on, company customers don't see the widget. Test while logged out.

Hidden products and Blocked markets work on every Shopify plan, even though they sit in a card labelled Shopify Plus.

Still not working?

  • Clear your browser cache and check in a private/incognito window. Shopify's theme editor aggressively caches assets — what you see in your regular browser may be outdated.
  • Check if you're on a headless Shopify setup. If your storefront is built with Hydrogen, a custom headless framework, or a Webflow-to-Shopify bridge, the standard product page and cart drawer widgets are not compatible. Only the checkout extension widget works on headless stores (Shopify Plus required). Contact us to discuss your options.
  • Confirm you're checking the live published theme, not a draft. Go to Online Store → Themes and make sure the theme marked "Current theme" is the one where you enabled the Giftnote app embed. If you made changes on an unpublished theme, those changes won't be visible on your live store.
  • Chat with us using the chat button in the help centre or in the app — include your store URL and a screenshot of your App embeds panel (showing Giftnote toggled on), or of Settings → Overview → Online store widgets, so we can diagnose the issue quickly. We typically resolve widget visibility issues within 24 hours.