Articles on: App testing and setup

What are Monk app blocks and how are they used?

App blocks are customizable modules that let you add app functionality exactly where you want to use it in your theme. You can add, remove, preview, reposition, and customize app blocks through the theme editor. This doc is a guide on which app block pertains to which offer type and funnel

Why are app blocks used?
Types of App Blocks
- Product Page
- Cart
- Checkout

FAQ

Why are app blocks used?



In Monk, app blocks are primarily used for 2 cases-

To change a funnel's position on the Product page. Please refer to this article for more information on how to change the position.



To set up Checkout offers (Shopify Plus only) - without the app block at checkout, the funnels will not be displayed. Please refer to this article for more information on how to use app blocks to create Checkout offers.



Types of App Blocks



Product Page


There are 4 app blocks as shown below -



Bulk Discount - This needs to be added for ‘Bulk Discount: Specific products’ and ‘Bulk Discount: Group of products’ offers (Create new funnel > Cross-sell & product groups > Quantity/ bulk discounts).




Cross-sell - This needs to be added for the embedded ‘Product page cross-sell’ offer (Create new funnel > Cross-sell & product groups > Cross-sell [embedded] > Product page).




Gift selection - This needs to be added for ‘Free Gift Manual selection’ offer without banner and progress bar (Create new funnel > Gifts and shipping > Free gift [without banner and progress bar] > Manual Selection> Display- Product Page).




Product group embedded - This needs to be added for ‘Bundle offer for Product groups’ offer (Create new funnel > Cross-sell & product groups > Product groups > Product page [embedded] ).




Cart


It is not recommended to add app blocks on cart as it may cause display issues and interfere with the overall cart experience. To change the position on cart, feel free to contact us via live chat or email support and we'll get the widget's position customized for your store. You can also refer to this document which enlists steps on how to change the position of widgets on cart without having to rely on app blocks - https://monkcommerce.crisp.help/en/article/how-to-customize-locationposition-of-monks-widgets-jc9jyl/.

Checkout


There are 9 app blocks which are categorized according to the offer type as shown below -



Banner and Progress bar :



Gift auto add, shipping and discounts - This needs to be added when you want to set up a ‘free gift auto add/free shipping/discount’ offer with a progress bar on checkout (Create new funnel > Gifts and shipping > Free gift [with banner and progress bar] > Set display as checkout page in step 1 > Auto add/ Free shipping/ Discount [to be set up on step 2 of the progress bar funnel] )


Gift selection - This needs to be added when you want to set up a ‘free gift selection’ offer with a progress bar on checkout (Create new funnel > Gifts and shipping > Free gift [with banner and progress bar] > Set display as checkout page in step 1 > Free gift-selection [to be set up on step 2 of the progress bar funnel] )

Please note, if you are using Free gift selection through Cart progress bar on checkout, you need to add both app blocks - 'Gift auto add, shipping and discounts' and 'Gift selection' block under 'Banner and progress bar' section. Otherwise, the discount will not be applied on the free gift.

Subscription and shipping protection :

Monk : Shipping protection - This app block needs to be added when you want to set up a ‘shipping protection’ offer on checkout (Create new funnel > Shipping protection & subscription > Shipping protection > Checkout)



Monk : Subscription upsell - This app block needs to be added when you want to set up a ‘Subscription upsell’ offer on checkout (Create new funnel > Shipping protection & subscription > Subscription upsell > Checkout)



Without banner and progress bar :



Gift auto add - This needs to be added when you want to set up a ‘free gift auto add’ offer without a progress bar on checkout (Create new funnel > Gifts and shipping > Free gift [without banner and progress bar] > Auto add > Set display as checkout page in step 1)


Gift selection - This needs to be added when you want to set up a ‘free gift selection’ offer without a progress bar on checkout (Create new funnel > Gifts and shipping > Free gift [without banner and progress bar] > Manual selection > Set display as checkout page in step 1)


Note - The app blocks for gift auto add and gift selection are to be selected based on whether the offer is being set up with or without the progress bar on checkout. Please refer to the steps above for when to add which app block.

Cross-sell and dynamic content :

Monk: Cross-sell - This needs to be added when you want to set up a ‘cross-sell’ offer on checkout (Create new funnel > Cross-sell & product groups > Cross-sell > Checkout)


Monk: Dynamic content - This needs to be added when you want to set up a ‘dynamic content’ offer on checkout (Create new funnel > Checkout customizations > Dynamic content)


Product removal app block - If you want the customer to be able to remove the product from checkout, you can add this app block under the order summary section. This will appear as a bin icon below the product added to checkout from the Monk widget. This can enable the customer to remove any Monk offer product they have added from a funnel set up at checkout.


Note- You can leave the widget ID field empty because this is only required only in case of combinations. Please refer to this article for more information - https://monkcommerce.crisp.help/en/article/how-to-combine-two-funnels-of-the-same-type-at-checkout-shopify-plus-only-n7i088/

Frequently Asked Questions



1) I have added an app block on product page to change the widget position, but it still does not work. What can be done?

The issue could be stemming from one of two factors. First, a third-party app might be conflicting with the functionality of the app block, causing it not to work as expected. Second, it's possible that your theme doesn't fully support app blocks, which could prevent it from displaying or functioning correctly. Please reach out to support to change the widget position in such cases.

2) Why is the offer set up on cart not working?

If you have added an app block on cart, the offer might not work. It is not recommended to add app blocks on cart as it may cause display issues and interfere with the overall cart experience. To change the position on cart, feel free to contact us via live chat or email support and we'll get the widget's position customized for your store. You can also refer to this document which enlists steps on how to change the position of widgets on cart without having to rely on app blocks - https://monkcommerce.crisp.help/en/article/how-to-customize-locationposition-of-monks-widgets-jc9jyl/.

If you have any other questions or queries please reach out to us via chat support or write to us at support@monkcommerce.com

Updated on: 31/03/2025