In this article we'll go over how to set up Wrapped Gift Blocks on a custom theme.
Custom theme means any theme not originating from the Shopify Theme Store or that's been heavily customized by an agency or developer. These themes may require developer assistance to ensure our Gift Blocks know where to appear.
When possible we recommend purchasing your theme from the Shopify Theme Store or from credible theme developers with on-going support. Many third party themes are not held to the same rigorous standards and can provide challenges for apps to integrate with automatically. Some setup may be required.
Verified Themes may lose their Theme Store ID due to certain customizations or duplications, and may show up in our system as a custom theme. These will likely still work with no further setup required, unless the customizations done to the theme interfere with Wrapped directly.
What to check first
If the gift block is not showing on your storefront, it is often because your theme needs manual setup.
Turn on the app embed for the theme
On the gift option page, the Themes card lists each theme with On or Off. Press the theme you are working on. The theme editor opens on App embeds with the Gift Options app embed turned on for that theme. Press Save to keep it on.
Each theme row opens that theme in the theme editor
Turn on the gift block for the page
The Gift blocks card has a switch for the product details page, the cart drawer, and the cart page. On a theme that supports app blocks, the gift block is placed for you.
The Developer tools icon on each row opens the developer fields
Add the app block in the theme editor
For the product page and the cart page only. Add Gift option for Products on the product page and Gift option for Orders on the cart page. Custom themes may be unable to support app blocks. The steps are in Gift block is not appearing on storefront pages.
Developer tools
On the gift option page, press the Developer tools icon on a gift block row to show its developer fields. A developer can enter a class name in Manual reposition with HTML class name to place the gift block by hand, a good alternative when app blocks are not available in your theme. See Developer tools.
💡 This option is for skilled developers and partners only. We are unable to assist if the wrong value is entered. Clear the value and contact us instead.