Quantity Breaks Install Instructions

  1. Bold Commerce Help Center
  2. Quantity Breaks (Standalone) - Shopify
  3. Get Started
Avatar
Brysen
Published: 
Last Updated: 
  • Quantity Breaks
  • All Versions
  • Advanced liquid knowledge required
  • 30 Minutes+
 Alert

This article requires technical knowledge and prior experience with liquid code. If you are not comfortable with this, please contact our Merchant Success team for assistance.

Overview

Before you begin, review Notes Before Installing Apps. This article will help get you prepared and answers many common questions.

 Caution

If you would like to remove the liquid code from your theme, the liquid code can be removed by deleting the snippet files and the code includes mentioned in the instruction steps below. You can also request an uninstall request by contacting our Merchant Success team.

Note: If you are experiencing issues with performance on the storefront with Quantity Breaks after completing the steps below, we recommend requesting an expert installation, as your theme may require further liquid code changes.

Select each step below to view the instructions.

Step 1: Add Snippet Files

  1. Duplicate themes, to create a backup copy.
  2. From Shopify's admin, select Online Store.
  3. Select Actions.
  4. Select Edit code.

    Edit code

  5. Under "Snippets", find these files:
    • bold-product.liquid
    • bold-variant.liquid

    find these snippets

  6. For any that don't exist:
    1. Select Add a new snippet.

      add a new snippet

    2. Enter the correct snippet name from Step 5.
    3. Select Create snippet.

      select create snippet

    4. Copy and paste the code found in each of these links into their respective files:

      copy and paste this code

    5. Select Save.
    6. Repeat steps 6a – e for each missing snippet file.

Step 2: Edit collection.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.

    Edit code

  4. Under "Templates", select collection.liquid.

    Note: If your theme contains sections, you may need to open collection-template.liquid under "Sections" instead.

    select collection.liquid

  5. Find each instance of:

    {% for product in collection.products %}

    Note: If you can't find this code, look to see if the theme has a "product-loop.liquid". Can't find this code?

    find this code

  6. Paste this code on the line below each instance:

    {% include 'bold-product' with product, hide_action: 'skip' %}

    paste this code

  7. Select Save.

Step 3: Edit index.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.
  4. Under "Templates", select index.liquid.

    Note: If your theme contains sections, you may need to look under "Sections" instead. The file may be named: featured-products.liquid, home-collection.liquid, home-featured-products.liquid, featured-row.liquid, simple-collection.liquid, featured-collection.liquid, home-tab.liquid, home-big-product.liquid, index-products.liquid or tabs-collection.liquid.

    select index.liquid

  5. Find each instance of:

    {% for product in collection.products %}

    Note If you can't find this code, look to see if the theme has a "product-loop.liquid". Can't find this code?

    find this code

  6. Paste this code on the line below each instance:

    {% include 'bold-product' with product, hide_action: 'skip' %}

    paste this code

  7. Select Save.

     

Step 4: Edit related-products.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.
  4. Under "Snippets", select related-products.liquid.

    select related-products/liquid

  5. Find each instance of:

    {% for product in collection.products %}

    Note If you can't find this code, look to see if the theme has a "product-loop.liquid". Can't find this code?

    find this code

  6. Paste this code on the line below each instance:

    {% include 'bold-product' with product, hide_action: 'skip' %}

    paste this code

  7. Select Save.

     

Step 5: Edit search.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.
  4. Under "Templates", select search.liquid.

    select search.liquid

  5. Find each instance of:

    {% for item in search.results %}

    find this code

  6. Paste this code on the line below each instance:

    {% include 'bold-product' with item, hide_action: 'skip' %}

    paste this code

  7. Select Save.

Step 6: Edit product.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.
  4. Under "Templates", select product.liquid.

    select product.liquid

  5. Add this code to the top of the file:

    Note: If your theme contains sections, you may have to make these changes in product-template.liquid under "Sections".

    {% include 'bold-product' with product, hide_action: 'break' %}{% if bold_hidden_product %}{% break %}{%endif %}

    add this code to the top of the file

  6. Find each instance of:

    {% for variant in product.variants %}

    find this code

  7. Paste this code on the line below each instance:

    {% include 'bold-variant' with variant, hide_action: 'skip' %}

    Note: If your theme uses swatches, where variants are shown as buttons instead of through a drop-down menu, this code will also need to be added to a snippet file, usually named swatch.liquid or product-swatch.liquid.

    paste this code

  8. Find each instance of:

    product.variants.size

    Note: If you can't find this in the product.liquid file, then check the snippets folder for a product-form.liquid or short-form.liquid file and look for the code in there. 

  9. Replace each instance with:

    bold_variants_size

  10. Find each instance of:

    {{ product | json }}

    Note: If you can't find {{ product | json }} in those files, then try searching for it in the theme.liquid file. If it's not in the product.liquid or theme.liquid file, then that can be skipped.

    find this code

  11. Replace each instance with:

    {% include 'bold-product', output: 'json' %}

    replace this code

  12. Find the class in the <form> tag and paste this into the class:

    shapp_qb_prod

    Note: If there is no class, you will need to add one.

    find the class

  13. Add this code where you would like the quantity break grid to display on the product page.

    Note: It must be inside the <form> tag. A good place is above or below the add to cart button code in the file.

    {% unless qb_loaded == 'true' %}
<div class="shappify-qty-msg">{{bold_selected_or_first_available_variant.metafields.shappify_qb.pricing_html}}</div>{% assign qb_loaded = 'true' %}
{% endunless %}

    add this code

  14. Select Save.

Step 7: Edit cart.liquid

  1. From Shopify's admin, select Online Store.
  2. Select Actions.
  3. Select Edit code.
  4. Under "Templates", select cart.liquid.

    Note: If your theme contains sections, this code may be located under "Sections", in cart-template.liquid.

    select cart.liquid

  5. Add this code where you would like the "You saved ..." message to display:

    Note: This varies by theme but usually a good place for this is under the first line that contains <h1>. This will be near the top of the file.

    <!-- Bold: Quantity Breaks - Cart Savings Banner -->
<div id="shappify-qty-cart-msg"></div>
<!-- // end Bold code -->

    add this code

  6. Select Save.

     

Step 8: Update Pricing Code

Updates need to be done on all theme files that output product prices on the site. The number and name of the files will vary from theme to theme. Usually, 3-5 files will need to be updated, which will control the price fields on the product, collection, search, related-products (on the product page) and homepage pages. It's important that each theme file that outputs a price be modified, to ensure the correct pricing always shows.

When you're ready to proceed, select the "Files to Update" tab.

Go through the list of files, one file at a time, and then reference your theme's files to see if that particular file exists in the theme. Not all of these will appear in a given theme.

When you find a file that your theme has, select the "product.price" tab to continue.

  • "Templates" folder (all themes will have these files)
    • product.liquid
    • index.liquid
    • collection.liquid
    • search.liquid
  • "Snippets" folder (any given theme will typically have several of these)
    • product-block.liquid
    • product-card.liquid
    • product-form.liquid
    • product-grid-collage.liquid
    • product-grid-item-category.liquid
    • product-grid-item.liquid
    • product-list-item.liquid
    • product-listing.liquid
    • product-loop.liquid
    • product-single.liquid
    • product-thumbnail.liquid
    • product.liquid
    • related-products.liquid
    • search-result-grid.liquid
    • search-result.liquid
    • search.liquid
    • short-form.liquid
    • snippet-product-item.liquid
  • "Assets" folder (don't change anything in here)

When you've gone through the list, this step will be complete.

Look for each of these ... ... and replace all instances with this code
product.price bold_price
product.price_min bold_price_min
product.price_max bold_price_max
product.price_varies bold_price_varies
product.compare_at_price bold_compare_at_price
product.compare_at_price_min bold_compare_at_price_min
product.compare_at_price_max bold_compare_at_price_max
product.compare_at_price_varies bold_compare_at_price_varies
product.selected_or_first_available_variant bold_selected_or_first_available_variant
product.variants.first bold_selected_or_first_available_variant
product.variants[0] bold_selected_or_first_available_variant

Not all of these will appear in a given file, but the ones that do appear in a file may appear a few times.

If you found and replaced some of the above, then select the "Files to Update" tab and continue down the file list.

If the file has none of these, then select the "item.price" tab.

Look for each of these ... ... and replace all instances with this code
item.price bold_price
item.price_min bold_price_min
item.price_max bold_price_max
item.price_varies bold_price_varies
item.compare_at_price bold_compare_at_price
item.compare_at_price_min bold_compare_at_price_min
item.compare_at_price_max bold_compare_at_price_max
item.compare_at_price_varies bold_compare_at_price_varies
item.selected_or_first_available_variant bold_selected_or_first_available_variant
item.variants.first bold_selected_or_first_available_variant
item.variants[0] bold_selected_or_first_available_variant

Not all of these will appear in a given file, but the ones that do appear in a file may appear a few times.

If you found and replaced some of the above, then select the "File to Update" tab and continue down the file list.

If the file has none of these, then bring up the file editor's search feature (Ctrl+f), and do a search for ".price" (minus the quotes), and continue below.

If nothing is found after the search, or if you find "variant.price","variant.price_min","variant.price_max", or "variant.price_varies", then nothing will need to be done with this file, and you can select the "Files to Update" tab and continue down the file list.

If something is found after the search, take note of what was found, and then select the "Other" tab.

Some files in some themes will use something other than "product" or "item", and you'd need to change our code to work with what the file uses. For example, a file may use "product-detail" instead.

To proceed, substitute * with whatever was before the ".price" when you searched in the previous section, then look for that code in the file and replace what you find with the app's code.  Again, it's not necessary to change anything with "variant" in it, such as "variant.price".

For example, if you found "product-detail.price", then replace "*" with "product-detail" with each item below, and then look for that code in the theme. So, for the first item, you'd look for "product-detail.price", and if found, replace it with "bold_price".

Look for each of these ... ... and replace all instances with this code
*.price bold_price
*.price_min bold_price_min
*.price_max bold_price_max
*.price_varies bold_price_varies
*.compare_at_price bold_compare_at_price
*.compare_at_price_min bold_compare_at_price_min
*.compare_at_price_max bold_compare_at_price_max
*.compare_at_price_varies bold_compare_at_price_varies
*.selected_or_first_available_variant bold_selected_or_first_available_variant
*.variants.first bold_selected_or_first_available_variant
*.variants[0] bold_selected_or_first_available_variant

Not all of these will appear in a given file, but the ones that do appear in a file may appear a few times.

When you're done with this file, select the "File to Update" tab and continue down the file list.

Note: Visit Add the Quantity Box to the Product Page for detailed instructions to display the quantity box.

 

Was this article helpful?
4 out of 26 found this helpful