We have completely overhauled how you manage product recommendations. By merging the previously fragmented modules (Cross-sell, Featured Recommendations, and Groupkeys) into one central module, we’ve eliminated operational friction and shift to a more centralized control. And the module comes with a fresh layer of paint, like we did before at for example Filter Templates, Search Banners and the Builder. Stop switching between modules. Whether you are setting up manual picks or AI-driven alternatives, everything is now managed from one clear, unified interface.

This update introduces a sophisticated level of control over your merchandising logic. You can now seamlessly toggle between different recommendation types and refine them with accuracy. Through advanced filtering and conditions, you can ensure shoppers only see products that align with your specific goals, such as matching by color, brand, or price range. This ensures every recommendation is not only relevant to the user but also perfectly aligned with your current assortment.

To give you full mastery over the shopper experience, the new module is fully integrated with our Merchandising Builder. This allows you to define the exact structure, conditions, positioning, and number of products shown, all while utilizing reusable templates for effortless scaling. The fresh interface has been specifically optimized for the carousel principle, providing a clear visual representation of how your product sets will appear in your shop. This ensures that what you build in the office today, translates perfectly to a high-converting experience on the storefront tomorrow.

Beyond mere relevance, you can influence the order of recommended products based on business-critical metrics like margin, sales data, and real-time availability. By combining this commercial intelligence with our fresh, intuitive UI we are making product recommendations more scalable, effective, and easier to manage than ever before.


Minor releases introduce new features and improvements. Check out what’s new!

  • Delivery API | We have removed legacy search log information from our API responses. These logs were used in the Demoshop but are now superseded by structured search logs.
  • Backend API | We updated the docs of the autocomplete endpoint as it now is marked as deprecated in the OpenAPI specification. We've updated the description to also indicate the suggestion endpoints should be used instead. This is mainly done to guide LLMs using our OpenAPI specification to use the correct endpoints.
  • Backend API | We have removed the tn_cid parameter from the product recommendations call, as tn_cid is not applicable to that endpoint.

Tweakwise App

  • Tweakwise App | We've introduced some important changes to Tweakwise App > Dashboard. Dashboard tiles are improved with more context to relevant modules. Now you can view modules quotas, ongoing A/B Tests, Event Tag integration statuses and more additional information all in one place on your dashboard. In addition to that, the instance information panel has also been updated with a new design. An extra widget was added as well, containing your personal contact person (and information).
  • Tweakwise App | There was an uncaught exception for the XML-feed import when an XSLT transformation uses an unreachable url in the file. We've created an error message for this so its clear why the transformation fails.
  • Tweakwise App | We fixed a bug where Search Banners created in the new module would always show up, even if specific keywords were entered.
  • Tweakwise App | The default for value sorting in new filter templates and its attributes has been changed from 'ProductAmount' to 'Alphabetic (A-Z)'.
  • Tweakwise App | Fixed a bug where sometimes running a Builder A/B Test would prevent you from creating a new Builder template.
  • Tweakwise App | We have updated some Builder components icons (item, visual, tile size) to fit more their purpose. Also fixed a bug where the position number wasn't correct when adding a component to a Builder.
  • Tweakwise App | Fixed a bug in auto synonyms where it was possible that the input word was suggested back when generating AI synonyms suggestions from the API. We have now prevented this behavior. Besides that, the task which run AI synonyms at a daily basis, will no longer be considered as a 'beta' feature.
  • Tweakwise App | We are now showing the active running (or last completed) task in the header of the App. You don't have to check the tasks module all the time just to see that your task was not yet completed.
  • Tweakwise App | We've improved the performance of the Filter Template detail page.
  • Tweakwise App | You can now manage your Access Tokens, which are needed to authenticate with the Backend API, via the Settings module (now called API keys).
  • Tweakwise App | You can now use arrow keys and Enter to quickly navigate and select instances during login, no mouse required.
  • Tweakwise App | Fixed missing translation strings for quota-related messages so they display correctly in all supported languages.
  • Tweakwise App | Clicking an item link from the attributes preview now correctly navigates to the item detail page instead of a broken URL.
  • Tweakwise App | The Insights module is now extended with Event Tag implementation widget with an overview of all existing Event Tag events. The Dashboard card for this module now shows that all are required for full functionality apart from addToWishlist which is relevant but not crucial.
  • Tweakwise App | In case you have access to multiple organizations within Tweakwise App (formerly known as customers) there is a 'Change organization' button available in the instance selection popup list.
  • Tweakwise App | Creating a new AI Embedding attribute now lands you on a real page instead of a polite "Not Found."
  • Tweakwise App | Long lists in the menu can be scrolled again, especially when you've gone wild expanding everything.

Demoshop

  • Demoshop | The view selection on search pages (classic lister / search algorithms debug mode) is now retained in your cooking, meaning that once you select a different view you can refresh the page without losing this setting. The page size is now configurable in the settings overlay (also retained in your cookies).
  • Demoshop | Fixed a bug where the search algorithm scores were not displayed correctly anymore (when using search algorithms debug mode). This issue is fixed for both the 'Search algorithms per tile' and the 'Search results per algorithm' view.
  • Demoshop | We accidentally removed the 'Personalized profile matrix' from the page. It should now be visible again. Meanwhile, we have resolved intermittent issues with fetching AI-generated profile descriptions in the demo storefront.
  • Demoshop | Personalized recommendations were not receiving the configured profileKey, resulting in non-personalized results. This is now fixed.
  • Demoshop | We fixed a bug where setting the view from 'Lister Page' to 'Search algorithms per tile' on a search page would carry over to non-search lister pages without the option to change it.
  • Demoshop | We have fixed a bug where labels for Builder recommendation components would not show above an item on the lister page. Also some other labels were missing, which now has been resolved.
  • Demoshop | We have simplified the new search log by removing a column with not-so-useful labels, and made non-value scores for Smart Filters show a dash "-" instead of nothing.
  • Demoshop | We've fixed a bug that could cause an error in the Demoshop when there were zero results for a given search term.
  • Demoshop | Smart Filters overview under the lister page now correctly shows 0% score if 0 is returned from the API.

Plugin Studio

  • Plugin Studio | Initializing or transferring instances from one to another instance, now shows a list of available organization instances that are relevant for such action, i.e. only those with already initialized Plugin Studio. Until now the full list of all instances in an organization was shown.

Magento2Tweakwise

  • Magento2Tweakwise 9.0.0 | Added support for the latest Tweakwise suggestions endpoint. We have now expanded the 'Item suggestions' configuration to allow for multiple, dynamic item types (like products and content). This means you can now seamlessly integrate blogs, pages, and FAQs into your search suggestions, right alongside your products. Previously, the 'Items' section was mainly reserved for products. We have now mirrored the flexibility of our Suggestions Groups (Categories, Facets, and Search Phrases) within the Item Suggestions section.
  • Magento2Tweakwise 9.0.0 | Resolved an issue where specific events would fail when utilizing the latest export version in combination with Grouped Export logic.
  • Magento2Tweakwise 9.0.0 | Shifted Admin Facet logic to the ALP module to streamline core functionality and reduce dependency overhead.
❗️

Breaking change: Magento2Tweakwise 9.0.0

Admin facet functionality has been moved entirely to the Automated Landing Pages module. This was done to decouple core logic from landing page-specific features. After updating to Magento2Tweakwise 9.0.0, you must also update your ALP modules (Magento2AttributeLanding, Magento2AttributeLandingTweakwise) to their latest versions to maintain Admin Facet functionality and prevent configuration errors.

Magento2AttributeLanding

  • Magento2AttributeLanding 6.0.5 | Fixed an issue where the overview page image was incorrectly deleted after saving a page update, ensuring media remains intact.
  • Magento2AttributeLanding 6.0.5 | Implemented comprehensive multi-language support for Overview pages. This ensures content translates correctly across different storeviews and improves localization workflows.
  • Magento2AttributeLanding 6.0.5 | Added the missing admin URL to the DataProvider configuration data. This ensures proper routing and consistent data fetching within the Magento Admin panel.
🚧

Configuration update

If you are using custom Admin UI components that extend the ALP DataProvider, ensure your configurations are synced with the new Admin URL parameters to avoid UI breakages.

Magento2AttributeLandingTweakwise

  • Magento2AttributeLandingTweakwise 4.5.0 | Filters for Attribute Landing Pages are now loaded directly from the Tweakwise Backend API. This ensures that the filters displayed in the backend include hidden filters, providing a more accurate representation of the available data.

Magento2TweakwiseExport

  • Resolved a critical issue where simple products assigned to multiple parent products (e.g., multiple configurables) caused Tweakwise import failures. The system now generates IDs based on product relationships for grouped export: Configurable parent will be formatted as {simple_id}-{parent_id}, as non configurable parent defaults to {simple_id}-{simple_id}.
❗️

Breaking change: ID format modification

This update changes the primary Item ID format for Grouped Export. If the customer utilizes Tweakwise events and uses the Grouped Export, they must update the Magento2Tweakwise (v 9.0.0) module to ensure compatibility with the new ID structure. Failure to do so will cause certain events to stop functioning.

Magento2TweakwiseHyva

  • Magento2TweakwiseHyva 4.7.0 | Added full support for the latest Tweakwise suggestions endpoint.
📘

Module dependencies

You must update the base Magento2Tweakwise (v 9.0.0) module to leverage the full functionality of the new suggestions endpoint.

Magento2TweakwiseJS

  • Magento2TweakwiseJS 1.5.0 | Added the ability to pass language codes to the Tweakwise JS implementation. This ensures frontend components, such as search and filters, are initialized with the correct locale context for better multi-language support.
  • Magento2TweakwiseJS 1.5.0 | Removed custom logic that is now handled by Magento2AttributeLanding. This cleanup reduces technical debt and prevents logic duplication across the stack.
❗️

Breaking change: Logic migration

Custom logic related to Attribute Landing Pages has been removed from Magento2TweakwiseJS. If you rely on this module to handle ALP-specific behaviors without the latest Magento2AttributeLanding module installed, landing page functionality will break. To must update the Magento2AttributeLanding (v 6.0.5) module to maintain full functionality.

Following the success of this feature in our Magento implementation, we have now brought Attribute Landing Pages to Shopware 6.6 and 6.7. Merchants can now create dedicated, search-engine-optimized landing pages based on specific product attributes. This is a game-changer for marketing campaigns and SEO strategies - allowing you to easily spin up pages for specific brands, seasonal collections (e.g., "Blue Adidas Sneakers"), or promotional groups. And by moving the config of filtered result sets into a native CMS element, we eliminate the need for custom code or complex manual URL parameters.

  • Integrated CMS element: Seamlessly add the new "Attribute Landing Page" element to any Shopware landing page template.
  • Flexible filtering: Configure specific filters directly within the element to curate the exact product set you want to display.
  • Toggle visibility: Choose whether to show or hide the active filters on the frontend to create a cleaner, "boutique" shopping experience.
  • Native performance: The element automatically renders the optimized Tweakwise JS required for a high-speed storefront experience.
📘

SW-Tweakwise 5.7.0

Be aware that this version is only for Shopware 6.6 and 6.7. We will backport this feature to the Shopware 6.5 version soon.


We are proud to introduce the 'People Like You' component, a sophisticated AI-powered recommendation now available within the Tweakwise Builder. This new approach utilizes real-time vectorization to understand the intent of a user within seconds of them landing on your site. Inspired by collaborative filtering models, this component analyzes the unique user vector of an active session (capturing events such as ItemClicks, PageViews and Purchases) and instantly maps them against a global matrix of similar user journeys.

The core innovation lies in our transition from a siloed profileKey approach to a Vector Search methodology. In the past, fragmented or poor-quality event data often led to empty recommendation blocks or generalized top sellers that lacked personal resonance. With this new 'People Like You' component, the system identifies the 'best match' based on behavioral proximity. When a new User X interacts with a specific product, such as a pair of trousers or a sweater, our Embedding Model calculates their position in a multi-dimensional space and serves recommendations based on what similar high-intent shoppers ultimately purchased. This ensures that even if 99% of your profileKeys are new, your storefront remains intelligently adaptive rather than static.

For merchants, this component is designed for immediate adoption and operational efficiency. It integrates seamlessly with existing JS and API implementations, pulling from a nightly-updated Lakehouse of profile embeddings to ensure the AI logic is always grounded in the most recent consumer trends. By automating the decision-making process of which products to surface, we significantly reduce the manual effort required to manage complex merchandising rules. In the end, the 'People Like You' component is built to improve commercial outcomes by increasing Click-Through Rates (CTR) and conversion by showing shoppers exactly what they are looking for, even before they know it themselves.

AI Personal Products - Just For You

Meanwhile we have rebranded the 'Personal Products' component to AI Personal Products - Just For You. This change is not just a cosmetic choice; it is a strategic clarification of the value proposition we deliver to your shoppers. While the new 'People Like You' component focuses on behavioral similarity, 'Just For You remains the pinnacle of individualization. It utilizes a shopper’s specific, historical interaction data and real-time browsing signals to curate a storefront that acts as a personal concierge. This component creates a more emotive and customer-centric experience which ensures that every recommendation is not just a guess, but a data-driven reflection of the shopper’s personal interests.

📘

Event Tag

Implementing the Tweakwise Event Tag is essential to analyze the performance of your configuration, power our insights reports and support personalization. To support this, Tweakwise needs key e-commerce events on your platform. These are events such as product views, item clicks, add-to-carts, and purcha

Minor releases introduce new features and improvements. Check out what’s new!

API's

  • Delivery API | We've fixed a bug that could cause wrong colspan/rowspan values to be returned when multiple tile size components were used on a page.

Tweakwise App

  • Tweakwise App | We fixed a bug where some suggestion configurations would break the form when opened in a detail view.
  • Tweakwise App | We resolved the problem of not being able to unset an attribute as API attribute. And we fixed a problem where deleting derived attributes would return an error. You can properly delete derived attributes again!
  • Tweakwise App | To support year-over-year reporting, we have increased our data retention from 365 to 400 days in most of our Insights Reports. This ensures you to have enough data to compare current performance against the same period last year.
  • Tweakwise App | We've made some minor changes to the reports list view to be more like the other modules, although visually not a lot has changed.
  • Tweakwise App | We now support manual suggestions without specific categories. Simply go to the suggestions list view and check out the 'Manual suggestions' card on the right side!
  • Tweakwise App | Fixed a bug where the secondary 'Save' action on the 'Save & exit' button didn't do anything in some modules.
  • Tweakwise App | For A/B Testing, we have added the number of sessions when hovering over the distribution. The module itself got a small update in color scheme of statuses to match the new palette of Search Banners and upcoming Boost & Bury modules. Some optimalisations are done to the tables across Tweakwise App.
  • Tweakwise App | Error details are exposed in all toast messages, giving users more details in situations where something goes wrong!
  • Tweakwise App | An issue related to saving a datetime is fixed. Issue was that the time was decreased by 2 hours every time you saved. This is fixed now.
  • Tweakwise App | In the App when changing the instance you now always get redirected to the homepage.
  • Tweakwise App | The profile count and retention in days (related to personalization) were temporarily not visible on the Tweakwise App dashboard. This problem has been solved.
  • Tweakwise App | We resolved an issue where click statistics were only being attributed to tiles containing existing components on the Builder. Clicks are now correctly tracked and distributed across all tiles within the Builder, even if there is no active component allocated to a certain position. Clicks were also only visible once a Builder had at least one active component. Now we’ve updated the Builder Click Distribution to show data for all Builders, regardless of whether components are configured.
  • Tweakwise App | We fixed a bug in the publishing of Builder content items. We already published all Builders, but specifically the content items were only published when a Builder was connected to a category. We fixed this bug and now just like the other Builder items, the content items will always be published.
  • Tweakwise App | Fixed a bug in the Plugin Studio where attributes select for 'Text' elements would appear empty even though a value is selected (when opening an existing product tile).
  • Tweakwise App | Updated the Google Analytics 4 report page. When creating a new report, you can now select the type right from the detail page!
  • Tweakwise App | Fixed a bug where slider facets would shown on a filter template even when the start and end values of that slider were the same.
  • Tweakwise App | Extra information is shown on the Tweakwise Dashboard, containing your personal contact person (and information), and some 'technical' information regarding your implementation as well.
  • Tweakwise App | Fixed a small bug where you couldn't close the preview modal and was forced to refresh page.
  • Tweakwise App | Some attribute select inputs now contain a button to create a new attribute (redirect you to a create page in a new tab) for your convenience.

Demoshop

  • Demoshop | We found out that the Event Tag was not always active and passing through data in our Demoshop, leading to broken AB Testing debug functionality for example. It turned out that we were still checking old settings. We now have removed this check so that a Demoshop user always has a profileKey, regardless of the instance's configuration.
  • Demoshop | We changed the presentation of the item quick view in order to align it better with Tweakwise App. Additionally, you can now quickly open the Up & Cross Selling Recommendation rules in the App via the item quick view.
  • Demoshop | The Search log in the Demoshop now uses new debug data from navigation requests to create an understandable and better looking overview of the way a search term has traversed through the search algorithms pipeline.

Event Tag

  • Event Tag | All requests to Event Hubs (like itemClicks) in which a Builder was used, are now logged 'correct'. Previously, requests weren't logged for empty Builders (without components), or Builders which didn't put any items on the page, resulting in weird item click distribution for example.

Tweakwise JS

  • Search & Merchandising JS | Fixed a problem where the timing of the event hooks was a bit off when using the manual implementation.

This update significantly enhances your ability to deliver impactful visual merchandising and data-driven optimization within your Magento store. By introducing support for colspan and rowspan in the Tweakwise Builder, you can break away from standard grids to create dynamic, complex layouts that highlight key products or promotions. The expansion of our Event Tag (now including page impressions, add-to-wishlist, and add-to-cart) provides the granular behavioral data needed to measure shopper engagement and refine your commercial strategy with precision.

Magento2Tweakwise

  • Magento2Tweakwise 8.11.0 | Resolved an issue causing duplicate parameter values and fixed an issue when type was not set. Fixed a bug related to trailing slashes on category pages and made route parameters nullable.
  • Magento2Tweakwise 8.11.0 | Added attribute_code to the Tweakwise slug table, allowing customers to use attribute codes directly in their custom code. Custom development implementation is needed for this.
  • Magento2Tweakwise 8.11.0 | Added new Search and Lister Page impression events.
  • Magento2Tweakwise 8.10.0 | Resolved an issue where grouped products were not respecting visibility settings correctly within Tweakwise.
  • Magento2Tweakwise 8.10.0 | Added support for colspan and rowspan attributes. This data is now passed to the frontend, allowing for more dynamic and complex grid layouts in your search results and category pages.
  • Magento2Tweakwise 8.10.0 | Fixed a bug where certain attribute slugs (URL keys) were triggering errors during the synchronization process.

Magento2TweakwiseJS

  • Magento2TweakwiseJS 1.4.0 | Added new events for Add to Cart and Wishlist actions.

Magento2AttributeLanding

  • Magento Attribute Landing 6.0.4 | Resolved an issue when the category suffix was configured as a slash.

Magento2TweakwiseExport

  • Magento2TweakwiseExport 7.8.2 | Fixed a bug where child and parent products were not in the same batch, resulting in error while importing your feed into Tweakwise. This fix ensures grouped products no longer have missing information.
  • Magento2TweakwiseExport 7.8.1 | Improved the export logic to handle visibility states for both grouped and non-grouped products.

Magento2TweakwiseHyva

  • Magento2TweakwiseHyva 4.6.0 | Updated to be fully compatible with the new page impression events in the core module.
  • Magento2TweakwiseHyva 4.6.0 | Resolved a bug affecting uppercase keyup events.
📘

Internal Code Quality Module

For Magento2Tweakwise, Magento2TweakwiseJS, Magento2AttributeLanding, Magento2AttributeLandingTweakwise, Magento2TweakwiseExport we've updated the internal Code Quality Module to the latest version to ensure compliance with modern coding standards.

❗️

Important note

If you are using the Hyva theme, you must update both the Magento2Tweakwise and Magento2TweakwiseHyva modules to their latest versions.

Minor releases introduce new features and improvements for our Shopware plugin. Check out what’s new!

  • SW-Tweakwise 5.6.0 | We added properties in XML-feed containing the cheapest price of a product (sw-cheapestprice-net and sw-cheapestprice-gross) and if the product needs a from prefix for the price (sw-has-from-price) in case there are variants with different pricing.
  • SW-Tweakwise 5.6.0 | Resolved a timing issue for the productView and purchase events to make sure the events are collected correctly.
  • SW-Tweakwise 4.10.0 | We added properties in XML-feed containing the cheapest price of a product and if the product needs a from prefix for the price in case there are variants with different pricing.
  • SW-Tweakwise 4.10.0 | Resolved a timing issue to make sure all of the events are collected correctly.
📘

Duplicate notes?

The 4.x version of the plugin is compatible with Shopware v6.5 and v6.6. The 5.x version of the plugin is compatible with Shopware 6.7. Click this link to visit corresponding repository and update on Github.

Designed to align with the modern, high-performance standards of the Tweakwise platform, today we announce a visual and structural rebuild of our Search Banners module. While the core utility of delivering clickable advertisements on your search results pages remains unchanged, we have entirely reimagined the user interface to prioritize speed, clarity, and ease of use. This update transitions the module into a more intuitive workspace, allowing merchandisers to navigate their promotional assets with significantly less friction.

Beyond the aesthetic overhaul, we introduce some small enhancements to help you manage campaigns more efficiently. The new overview now features filtering capabilities (enabling you to pinpoint specific banners instantly) alongside a bulk deletion tool to streamline your cleanup processes. These refinements ensure that your team spends less time on manual administration and more time crafting the targeted visual experiences that drive conversion and brand visibility.

The updated Search Banners module is live and ready to use. Whether you are highlighting seasonal offers or stimulating sales for specific brands, this refreshed interface provides the necessary toolkit necessary to manage your search-driven marketing with precision.

This release significantly elevates the Tweakwise Insights module by adding extra functionality to our Conversion Report. By centralizing search-specific metrics and introducing comparative funnel visualizations, we are moving away from raw data toward actionable narrative insights. This update empowers you to quantify the direct correlation between search behavior and bottom-line revenue.

Conversion Report

The Conversion Report has undergone a strategic evolution to provide a more unified view of how search behavior impacts your bottom line. We have streamlined the interface by merging the Session Search Insights directly into the Conversion Dashboard. This consolidated view eliminates redundancy and introduces a new comparative trend line, allowing you to instantly benchmark specific search conversion against your store's overall conversion rate. To ensure these metrics are ready to use for all of your team members, we have also added interactive information overlays to every data card, providing clear definitions and context via hover-activated tooltips.

A major addition to this release is the Customer Journey Breakdown page, designed specifically to visualize the value of search. By isolating sessions into 'With Search' and 'Without Search' cohorts, merchants can now compare high-level funnel performance across five critical stages: Sessions > ItemClicks > PageViews > AddToCarts and Purchases. This is essential for demonstrating how effectively Tweakwise search propels shoppers through the buying process compared to standard navigation, highlighting exactly where the search experience adds the most commercial value.

To further optimize the search experience, the new Search Performance page provides a deep dive into individual search phrase health. This report moves beyond simple volume metrics to track sophisticated engagement indicators like Search Abandonment and Search Refinement rtes. By analyzing these behaviors alongside traditional conversion data, you can identify high-intent terms that fail to convert or require immediate synonyms and boosts. Each key metric now features a trend analysis view, enabling you to monitor the long-term impact of your merchandising adjustments.

📘

Event Tag

Implementing the Tweakwise Event Tag is essential to analyze the performance of your configuration, power our insights reports and support personalization. To support this, Tweakwise needs key e-commerce events on your platform. These are events such as product views, item clicks, add-to-carts, and purchases.