Common Issues

And their solutions!

Config Error on the Connect Widget

Custom Domain

This error will happen if your store has a custom domain and does not use the default helloworld.myshopify.com domain.

To fix this, make an app in the Manifold Developer Portal with the following settings:

  • App Name: <YOUR STORE NAME> (e.g. "My Cool Store")

  • Description: <YOUR STORE DESCRIPTION>

  • Grant Type: Token

  • Redirect URI: <YOUR CUSTOM DOMAIN WITHOUT TRAILING SLASH> (i.e. https://helloworld.com)

Once you do this, the Shopify Merch Bridge will recognise your custom domain.

Changed Store Name

This will also happen if you changed your store name. To fix it, simply uninstall and reinstall the Manifold Token Gate by visiting <your shopify store>.myshopify.com/admin

Quantity is always 1 when adding a gated item

The Manifold Merch Bridge relies on <div> class names to retrieve the selected quantity when adding a gated item to the cart. This issue arises when you are using a custom theme and the <div> tag enclosing quantity input field does not have the proper id.

To fix this issue, ensure that the parent <div> of the quantity input box has the class quantity.

Example:

The Debut theme needed the following modification within the section/product-template.liquid file:

<div class="quantity">
  <label for="Quantity-{{ section.id }}">{{ 'products.product.quantity' | t }}</label>
  <input type="number" id="Quantity-{{ section.id }}"
    name="quantity" value="1" min="1" pattern="[0-9]*"
    class="product-form__input product-form__input--quantity" data-quantity-input
  >
</div>
Cart icon not updating when a gated item is added

This can occur if you are using a custom theme where the section's <div> does not match the section name. To correct this, add ensure the id prop of the section <div> matches the section name, and ensure that the data-cart-icon-section property is set with the corresponding sections that contain the cart icon (see UI Configuration Options).

Example:

The Debut theme needed the following customizations because the cart icon is located within sections/header.liquid:

  1. snippets/manifold-campaign-widget.liquid

    <div data-widget="m-add-to-cart" data-cart-icon-section="header">
    </div>

  2. snippets/header.liquid (modify so that the header div has the id value of 'header')

    <div id="{{ section.id }}" data-section-id="{{ section.id }}" data-section-type="header-section" data-header-section>
Add to cart button hidden

When setting up a gate there is a checkbox to indicate if a token exclusive or not. If “exclusive” is checked off the regular add to cart will not show.

Last updated