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 offer


Why are app blocks used?

Types of App Blocks


FAQ


Why are app blocks used?


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


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



  1. To set up Checkout offers (Shopify Plus only) - without the app block at checkout, the offers 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 -


  1. Bulk Discount - This needs to be added for ‘Bulk Discount: Specific products’ and ‘Bulk Discount: Group of products’ offers (Create offer > Cross-sell & product groups > Groups and quantity break > Quantity/ bulk discount > Custom build your discount > Specific products or Group of products).


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




  1. Gift banner-auto add - This needs to be added if you want to display banner for 'free gift auto add' offer (Create new offer > Gifts, shipping and cart goals > General free gifts > Auto add > In step 1 of offer set up, under section 'Select the position to show offer banner', enable for product page).


  1. Gift selection - This needs to be added for ‘Free Gift Manual selection’ offer without banner and progress bar (Create new offer > Gifts, shipping and cart goals > General free gifts > Manual Select > 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.


Checkout


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



  1. Cart goals and free gift :


  • Progress bar - This needs to be added when you want to set up a progress bar with ‘free gift auto add/gift selection/free shipping/discount’ offer on checkout (Create offer > Checkout page gifts, order goals and cross-sell > Cart based goals)



  • Gift auto add - This needs to be added when you want to set up a ‘free gift auto add’ offer on checkout ( Create offer > Checkout page gifts, order goals and cross-sell > General free gifts > Auto add).


  • Gift selection - This needs to be added when you want to set up a ‘free gift selection’ offer on checkout ( Create offer > Checkout page gifts, order goals and cross-sell > General free gifts > Manual select)


  1. 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 offer > Checkout page gifts, order goals and cross-sell > cross-sell).


  1. Product remove button - This app block can be added if you want the customer to be able to remove any offer product added at checkout from Monk. The app block will add a 'bin' icon under the product which upon clicking, the customer can remove the same.






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.


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.


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: 21/11/2025