Per-Item Gift Wrapping

Open your Shopify Theme Editor → navigate to a Product template → click the Per-Item Gift Wrapping block → use the Gift Wrap Product picker to select your Gift Wrapping product. Colour variants populate automatically — no IDs to copy.

The Gift Wrap Product picker in the block settings is empty. Open Theme Editor → click the block → set the product. Once set, all variants of that product appear in the dropdown automatically.

Go to Shopify Admin → Products → Gift Wrapping → Variants. Add, rename, or delete variants there. Changes appear in the dropdown on your store immediately — no theme save needed.

Set it to Draft. This hides it from your storefront, search results, and collections so customers cannot buy it directly. The cart API can still add it — that is how the extension works.

Yes. Open each product template in the Theme Editor and add the block to each one. The same Gift Wrap product and settings can be shared across all templates.

The display price shown on the block is cosmetic only — it tells customers what to expect. The real charge comes from the actual price set on your Gift Wrapping product variants in Shopify Admin. Keep both in sync to avoid confusion.

This is intentional. The extension monitors the cart and automatically removes any gift wrap whose parent product is no longer present. This prevents orphaned gift wrap charges appearing on orders without a wrapped item.

The extension handles this safely. It waits until the product is confirmed in the cart before enabling auto-removal. Selecting wrap before adding the product will not cause the wrap to disappear unexpectedly.

No. The extension enforces one gift wrap per product at all times. If a customer tries to add wrap for a product that already has one, the existing wrap is updated instead.

By default the quantity selector for gift wrap rows is hidden (recommended). This prevents customers from setting qty to 2 while only having 1 of the product. You can toggle this under Cart Behaviour → Hide quantity selector in the block settings.

Currently one gift wrap is added per product line (not per unit). If you need qty-matching, that would require a customisation — please open a developer issue with your use case.

This was a bug in earlier versions where the cleanup logic could call itself in a loop. It is fixed in v6. Run shopify app deploy to push the latest version. If the error still appears after deploying, clear your browser cache and try again.

Go to Shopify Admin → Orders and open any order. Each gift wrap line item has a Wrapped item property showing the product title it belongs to. If the customer added a message, a Gift message property also appears on that line.

The gift wrap line item shows the variant name (e.g. Gold, Gray) in the Variant column of the order, alongside the Wrapped item property.

In Shopify Admin → Orders, use the search bar and filter by product name "Gift Wrapping". For bulk exports with line item properties, use the built-in order export (CSV) or a reporting app such as Report Pundit or Better Reports.

Yes. Gift Wrapping is a real product added to the cart, so it appears as its own line on the order confirmation email, packing slip, and invoice — just like any other product. The Wrapped item property tells your team which item it belongs to.

Not natively — the price comes from the Gift Wrapping product variant, which is a single price. A workaround is to create multiple Gift Wrapping products (e.g. Standard Wrap / Premium Wrap) and add a separate block for each one on different product templates.

Open the Theme Editor → click the block → find Visual Customisation → Accent colour. Pick any colour from the colour picker. It updates the checkbox fill, price text, and focus ring throughout the block.

Yes. Open the block settings → Gift Message → Allow customers to add a gift message → toggle off.

These labels are currently hardcoded in the Liquid template. To change them, edit extensions/gift-wrapping/blocks/gift_wrap.liquid and update the label text, then run shopify app deploy.

In the Theme Editor, drag the Per-Item Gift Wrapping block up or down in the block list on the left panel. It will reposition on the product page accordingly.

Check two things:
1. Development: Is shopify app dev running? The extension is only served while the dev server is active.
2. Production: Has the app been deployed (shopify app deploy) and installed on the store via the Partner Dashboard? Both steps are required.

Make sure you are running v6 of the extension. Check by opening your browser console on a product page and looking for [GiftWrap] log lines — version is shown in the first line. If on an older version, run shopify app deploy.

The reorder logic targets Dawn's <table> cart structure. Some themes use a <ul> or custom element. Open a browser console and run document.querySelector('.cart-items')?.tagName and share the result — it helps diagnose the structure your theme uses.

This is caused by an infinite loop in older versions of the extension. Deploy the latest version: shopify app deploy. Also clear your browser cache after deploying — an old cached JS file can still cause the error even after deployment.

The admin web page requires HTTPS. Either:
1. Run npm run web to start the HTTPS server, then visit https://localhost:3000 and click Advanced → Proceed to localhost to trust the cert.
2. Or re-generate the cert: openssl req -x509 -newkey rsa:2048 -keyout web/certs/key.pem -out web/certs/cert.pem -days 3650 -nodes -subj "/CN=localhost"

A previous dev process is still holding the port. Kill it:
lsof -ti tcp:9293 | xargs kill -9
Then restart shopify app dev. Always stop the server with Ctrl+C or press q in the CLI panel — never use Ctrl+Z.

Open Theme Editor → find the Per-Item Gift Wrapping block → click the three-dot menu → Remove block. This removes it from the theme without uninstalling the app. To uninstall the app entirely, go to Shopify Admin → Apps → Gift Wrap App → Delete.

Three steps:
1. shopify app deploy — pushes the extension to Shopify's CDN.
2. Partner Dashboard → Apps → Gift Wrap App → Select store → choose your production store → Install.
3. Open Theme Editor on the live store → add and configure the block → Save.

No. After the first install, just run shopify app deploy whenever you make code changes. The update is pushed to all stores where the app is installed automatically. No theme re-save is needed.

No. Deploying only updates the JavaScript and CSS assets served from Shopify's CDN. The Liquid block and schema settings remain unchanged unless you explicitly modify them. Existing block configurations on live themes are preserved.

Yes. From the Partner Dashboard, install the app on as many stores as you own. Each store gets its own independent block configuration in its Theme Editor.