How to Fix Side Cart Refresh Issue for Free Gift Addition

This guide provides solutions for a common issue where a free gift is not automatically displayed in the side-cart or AJAX cart until the page is manually refreshed.

Method 1: Configure Cart Refresh Selectors (Recommended First Step)

This method tells the app which specific parts of your theme to refresh.

1. Find Your Side-Cart's Selector and ID

• • On your storefront, open your side-cart.
  • Right-click on the side-cart area and select Inspect from your browser's menu.
  • In the developer tools, locate the main container element for the side-cart. Identify a unique CSS class (e.g., side-cart-container) and its id or data-section-id (e.g., cart-drawer).
  • Tip: To check if a class is unique, copy it, press Ctrl+F (or Cmd+F on Mac) in the inspector, and ensure there is only one match.

2. Add the Selector and ID in Kite Settings

• • In the Kite app, navigate to Settings > Widget settings.
  • Scroll down to the "Cart refresh settings" section.
  • In the "Sidecar selector" field, paste the CSS class you found, making sure to start it with a period (e.g., .side-cart-container).
  • In the "Sidecar section ID" field, paste the Section ID you found. Do not add a . or # prefix.

3. Save and Test

• • Click Save. Clear your cart and test the free gift process again. If the cart now updates automatically, the issue is resolved. If not, proceed to Method 2.

Method 2: Use a Custom JavaScript Script (Advanced)

If the first method doesn't work, you may need to add a custom script to trigger your theme's specific cart refresh function.

1. Navigate to Custom JS Scripts

• • In the Kite app, go to Settings > Custom JS scripts.

2. Add the Refresh Script

• • Find the text box labeled "Execute Custom logic after free gift addition".
  • You will need to add a small piece of JavaScript that calls your theme's unique cart update function. This script is highly theme-dependent.
  • The app provides some common examples for popular themes for your reference. You may need to consult your theme's documentation or a developer to find the correct function for your store.

3. Save and Test

• • Add the script, click Save, and test the free gift process again.

Still Not Working?

If neither of these methods resolves the issue, please contact our support team via chat. We can help you find the correct selectors or script for your specific theme.

Updated on: 04/09/2025