Skip to main content

Integration guide: custom theme setup

Updated yesterday

In this article we'll go over how to set up Wrapped Gift Options on a custom theme.

Custom theme = any theme not originating from the Shopify Theme Store or that's been heavily customized.


This article covers:

  • What to check first (it may work right away)

  • Developer tools (how to do it yourself)

  • When to contact support


Note: 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.

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


What to check first

If the Gift Block isn’t showing on your storefront, it’s often because your theme requires manual setup.

To manually set this up:

  1. Activate the app in from the theme editor

    Visit the themes section in Wrapped to see your theme library, select Activate or Customize beside the theme you are working on. This step is often overlooked and is the most important for gift blocks to appear in your storefront. You must press Save to activate.

  2. Add the app block in your theme editor (for Product page and for Cart page only).

    Custom themes may be outdated and unable to support app blocks.

Gift block settings indicating where to request support

Developer tools

Use Developer Tools to manually add a custom selector for the gift block.

Note: This option is for skilled Developers/Partners only. We are unable to assist if the wrong value is entered. Instead you must clear the value and contact us.


When to contact support

Contact our support team by clicking “Block not appearing? Report an issue” in the app settings.

Note: A paid plan may be required for setup on certain/complex custom theme

Did this answer your question?