Koala Free Gift + GemPages Integration Guide
In this guide, you will learn how to integrate Koala Free Gift with GemPages Page Builder.
App block Types
- Our app comes with three app blocks that you can find in the Shopify theme editor called:
- Announcement Bar,
- Product Page Upsell,
- Product Page Widget.
The Announcement Bar and Product Page Widget app blocks refer to the Announcement bar and Product page widget options you may find in the Offer exposure section within a gift offer. And the Product Page Upsell app block refers to all upsell offers.
Adding the correct app block allows you to place the widget exactly where you want it and can help resolve layout or compatibility issues.



App block Integration
- Navigate to the Shopify Apps section within GemPages and add the Shopify App app block.

- Next, drag & drop the app block onto the section where you would like your widget to appear.

- Publish the page. Then, click the Shopify app block and open the Shopify editor.

- From the Shopify editor, click on the section that contains the Shopify App block you placed in GemPages.

- Click Apps in the pop up and add the correct app block from the dropdown. In this example, the Product Page Widget app block is added.

- The widget should now load and appear in the preview exactly where you placed the Shopify App block in GemPages.

Updated on: 09/12/2025
Thank you!
