1. 📝 Introduction to Category Grid Callouts

Transform your static Magento 2 category pages into dynamic, high-converting merchandising tools. The JaJuMa Category Grid Callouts extension is a precision tool for developers and merchandisers who demand full control over their category page layout.

Unlike other solutions that simply place content on a page, our extension intelligently injects content into the grid. This preserves your theme's layout and ensures a flawless, native appearance, solving common issues like broken grids or misaligned products.

1.1 🚀 Why Use Category Grid Callouts?

The category page is one of the most critical steps in the customer journey.
A generic, static grid of products can lead to missed opportunities. By injecting eye-catching callouts - or as we like to call them, Eye-Catchers, Stoppers, and Disrupters - you can:

• Guide Customer Attention:
  Actively point customers to special offers, new arrivals, and key product highlights exactly when they are in a browsing mindset.
• Create New Advertising Space:
  Open up valuable new real estate within your category pages for recommendations, cross-promotions, and advertising campaigns without cluttering your design.
• Enhance Visual Merchandising:
  Break up the monotony of the product grid with rich content like buying guides, lifestyle images, or video, creating a more engaging and curated shopping experience.

1.2 🎯 Key Features at a Glance

• Two Powerful Callout Types:
  • Grid Items:
    Insert content that behaves like a native product in your grid, perfect for subtle promotions or linking to related content.
  • Banners:
    Display full-width banners between product rows for high-impact campaigns and announcements.
• Precision Placement Control:
  Inject content at any position within the product grid, giving you complete control over your category page layout.
• A/B Testing with Random Callouts:
  Use the "Random Banner" and "Random Grid Item" types to automatically rotate different creatives in a single position, allowing you to test which messages perform best.
• Advanced Layout Integrity:
  An optional setting automatically adjusts the number of products on paginated results to ensure perfectly even grids with no blank spaces at the end - a common issue with other banner solutions.
• Targeted Display Rules:
  Configure callouts to appear on all categories, specific categories, or even by URL path. You can also target specific pagination pages for highly granular campaigns.
• Rich Content with Page Builder:
  Create engaging content - from simple images and text to complex HTML, CSS, and video - using Magento's native Page Builder or WYSIWYG editor.
• Built for Modern Magento:
  Enjoy out-of-the-box compatibility with Luma, Hyvä, and Mage-OS, with specific settings to ensure a perfect fit. The extension is 100% open source and built to the highest coding standards.

1.3 📸 See It in Action

Below are examples of how the two main callout types appear on the frontend.

Grid Item Example

A content block seamlessly integrated into the product grid in the third position, behaving just like a product tile.

Banner Example

A full-width banner placed after the third row of products, creating a clear visual break for a major promotion.

1.4 📚 How This Documentation is Structured

This documentation is designed to be a complete resource for users of all skill levels.

• All Users:
  • Start with this Introduction to understand the core benefits and features.
  • The Configuration Guide provides a deep dive into every setting, explaining how to create, place, and manage your callouts.
• Developers & Advanced Users:
  • Refer to the FAQ & Advanced Usage section for details on 3d Party / AJAX compatibility and other technical topics.

1.5 📌 How To Navigate The Extension

All extension settings can be found in your Magento Admin Panel under the JaJuMa menu item.

• JaJuMa -> Category Grid Callouts -> Configuration
  • Access global settings to enable the extension and configure its compatibility with your store's theme.
• JaJuMa -> Category Grid Callouts -> Category Grid Callouts
  • This is where you will create, edit, and manage all of your individual callouts.

1.6 📞 Need Help?

Still have questions or need help with your configuration? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.