Skip to main content

Integration guide: Custom theme setup

Learn more about configuring Wrapped gift blocks for custom themes

Updated over a month ago

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.

List of Themes with various statuses and notes which themes require custom setup.

What to check first

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

  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 unable to support manually added app blocks.

Developer tools

Use Developer Tools in your Gift Option settings to reveal HTML selector input fields to manually position the gift block. This is meant for developers and allows fine-tuning of gift block positioning, and a good alternate solution when app blocks are not available in your theme.

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 directly in the app, our team will review the theme and let you know how to proceed or assist with the gift block positioning.

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

Did this answer your question?