Just Launched

Omnibus Directive


Show the lowest price of the 30 days before a price reduction on product pages, category pages and search results, as EU Directive 2019/2161 requires. The price history is recorded automatically per store view.
Links
15 day Money Back Guarantee One Time Payment
Magento Cloud Support GraphQL Support Hyvä Support Adobe Approved Private Composer Repo
Documentation

Omnibus Directive for Magento 2

The Lowest Price of the 30 Days Before a Discount, Next to Every Sale Price

Showing a previous price with a discount is not optional in the EU. Directive 2019/2161, known as the Omnibus Directive, requires that every announced price reduction states the lowest price the product had in at least the 30 days before that reduction. The Omnibus Directive extension for Magento 2 keeps that price history and puts the line next to the price.

The extension records every price change per store view: product saves, imports, mass updates, catalog price rules and a daily snapshot. From that history it works out the prior price and shows it on product pages, category pages, search results and product widgets, with a template for Luma and one for Hyvä.

You set the lookback period, the price types that count, the label text and the pages where the line appears. The storefront reads from a dedicated index, so nothing is calculated while a page loads.

Product page of the Fjord Table Lamp at Nordic Living with a special price of €70.00 and below it the line with the lowest price in the 30 days before the discount, €100.00

What the Omnibus Directive Extension Does

Automatic Price History

Every price change is stored per store view, from product saves, imports, mass updates, catalog price rules and a daily snapshot.

The Prior Price the Directive Asks For

The line shows the lowest price in the 30 days before the current price took effect, not the lowest price counted back from today.

Product Pages, Listings and Search

Show the line on product pages, category pages, search results and product widgets, in Luma and in Hyvä.

Configurable Products

The parent follows its cheapest enabled variant, and the line updates when the shopper picks an option or swatch.

Control Over the Display

Choose the display mode, label text and position, and exclude categories, SKUs or single products.

Built for Large Catalogs

A dedicated index and a message queue keep imports and price rule updates away from the page load.

A Legal Requirement, Covered by the Default Settings

EU Directive 2019/2161 applies whenever you announce a price reduction: next to the new price you have to show the lowest price of the period before it. The directive sets that period at 30 days or more, and "Lookback Period (days)" is set to 30 by default. The admin shows the reference to the directive right below the field.

Under "Price Types" you choose which prices count toward the tracked final price: "Special Price", "Catalog Price Rule" and "Tier Price (qty 1, all groups / NOT LOGGED IN)". "Regular Price" is always included, and all four are on by default. The tracked price is the lowest of the selected types.

Tracking covers simple, virtual and downloadable products, and configurable products when "Track Configurable Products" is set to "Yes". Changes that happen by date, such as a special price with a start date, are picked up by the daily snapshot at 01:30.

Pricing settings with Lookback Period (days) set to 30, the four price types selected and Track Configurable Products set to Yes
Price line of a product that goes from €100.00 to €70.00 on 1 March and to €60.00 on 10 March, with the 30 days before 10 March marked and €70.00 as the lowest price in that period

How the Lowest Price Is Calculated

The 30 days are counted back from the moment the current price took effect. A discount that has been running for two weeks is still compared with the prices before it started, not with its own sale price.

Take a product that cost €100.00 for months. On 1 March a special price of €70.00 starts, and the line shows €100.00. On 10 March the price drops further to €60.00, and the line shows €70.00: the lowest price in the 30 days before that second step. On 20 March the product goes back to €100.00 and in "Only on Sale" mode the line disappears.

A discount in steps is therefore always compared with the previous step. When no earlier price is known, the current price is used, which is why it pays to record prices before a campaign starts.

Decide When and Where the Line Appears

"Display Mode" has three options. "Only on Sale", the default, shows the line when the final price is lower than the regular price. "Only when Different" shows it when the lowest price differs from the current price, and "Always" shows it on every product with a price history.

"Label Text" holds the sentence in front of the amount. The default is "Lowest price in the %1 days before this discount:", where %1 is replaced by the lookback period. The default text is English and the field is set per store view, so you enter your own text for every other language. With "Display Position" the line goes after or before the price, and "Custom CSS Class" adds your own class to the wrapper.

"Show on Listing" covers category pages, search results and product widgets, "Show on Product Page" the product page. Both are on by default. The amount follows the tax display and the currency of the store view.

Frontend settings with Display Mode set to Only on Sale, the label text and the display position, next to a category page where only the discounted lamp shows the lowest price line
Two views of the Linen Bathrobe product page: with size M selected the line shows €79.00, with size L selected it shows €89.00

Configurable Products Follow the Selected Variant

With "Track Configurable Products" set to "Yes", a configurable product is tracked with the lowest price of its enabled child products. That is the amount the shopper sees before making a choice.

On the product page the line updates as soon as an option or swatch is selected: size M shows the prior price of size M, size L that of size L. A variant that has nothing to show hides the line, and an incomplete selection brings the parent value back.

This works with dropdowns and swatches in Luma, and through the configurable-selection-changed event in Hyvä.

An Optional Price History Chart for Shoppers

"Show Chart on" adds an info icon next to the lowest price. On hover or keyboard focus it opens a small "Price history" chart of the price in the lookback period. Pick "Product page", "Category pages, search results and widgets", or both. Leave the field empty, as it is by default, and no chart is shown.

The chart is a stepped line, because a price holds until the next change. It is rendered on the server as an inline SVG, so no JavaScript library is loaded in the storefront. The icon only appears when there are at least two price points to draw.

Show Chart on set to Product page, next to a product price where the info icon behind the lowest price line opens a small Price history chart
Exclude Categories with the Outlet category selected and Exclude SKUs with two SKUs, next to the product attribute Hide Omnibus Lowest Price set to Yes

Exclude Categories, SKUs or a Single Product

Not every product has to show the line. "Exclude Categories" hides it for all products in the selected categories, and "Exclude SKUs" takes a list of SKUs separated by commas or new lines.

For excluded categories and SKUs the price history is still recorded. Remove the exclusion later and the line is back with the correct amount.

For a single product there is the attribute "Hide Omnibus Lowest Price" in the product form, which can be set per store view.

Self-Test, Logs and Commands to Check the Data

The "Run Self-test" button at the top of the configuration page checks the setup after installation. With "Debug Mode" on, price changes, snapshots and recalculations are written to a debug log. Errors are always written to the error log. Both logs have their own button in the configuration: "Debug Log" and "Error Log".

Three commands cover the command line:

  • bin/magento omnibus:snapshot records the current prices, optionally with --product-id, --store-id or --async.
  • bin/magento omnibus:recompute recalculates the lowest prices from the history, with --all, --product-id or --store-id.
  • bin/magento omnibus:cleanup removes old history, with --days and a --dry-run to see the effect first.
Logging settings with Debug Mode and the Debug Log and Error Log buttons, next to a terminal with the snapshot, recompute and cleanup commands

Omnibus Price History grid with the price changes of the Fjord Table Lamp per date, the Snapshot now button and the View history action per row

Every Recorded Price in One Grid

Under "Catalog" > "Inventory" > "Omnibus Price History" each recorded price change is a row, with the columns "Product Name", "SKU", "Store View", "Price", "Special Price", "Final Price" and "Date". You can see when a price changed and what the tracked final price was at that moment.

"Snapshot now" records the current prices on the spot, for example right after installation or before a campaign. "View history" opens the history of one product, with the lowest price of the lookback period and an "Edit Product" button.

Omnibus Directive for Magento 2: Technical Details for Developers and Store Owners

The Advantages for Developers

  • Index: the storefront only reads from the mm_omnibus_lowest_price index. Listing pages load all products of the collection in one query.
  • Queue: imports, mass updates and catalog price rules are processed through the omnibus.price.snapshot queue. A product save is processed directly.
  • Cache: when a lowest price changes, the full page cache of that product is cleaned by cache tag.
  • Markup: div.omnibus-price[data-role="omnibus-price"] with .omnibus-price__label and .omnibus-price__value, plus your own class from "Custom CSS Class".
  • Themes: a Luma template and a Hyvä template with Tailwind classes. On Hyvä the product page is covered for the View block (up to 1.3) and the Price block (1.4 and later).
  • Requirements: Magento 2.4.4 or higher and PHP 8.1 or higher.

Good to Know for Store Owners

  • Off after installation: turn the extension on with "Enabled" under "Stores" > "Configuration" > "Magmodules" > "Omnibus Directive".
  • No history from before: tracking starts when the extension is enabled. Run "Snapshot now" or bin/magento omnibus:snapshot right away, and do so before a campaign starts. A product that is already discounted at the first snapshot gets its sale price as the lowest price.
  • Long discounts: history is kept for the lookback period plus 7 days. A discount that runs longer loses its earlier reference price, and the sale price then becomes the lowest price.
  • Product prices only: the extension tracks regular prices, special prices, catalog price rules and tier prices. Discounts from cart price rules, or discounts that are only announced in a banner, are not covered.
  • Tier prices: these count for quantity 1, for all groups or for customers who are not logged in.
  • Product types: bundle and grouped products are not tracked.
  • Dates: a special price or price rule that starts by date is recorded by the daily snapshot at 01:30, so the recorded moment can be up to a day behind.
  • Scope: the "Pricing" settings apply per website, the "Frontend" settings per store view.

Show the Required Prior Price on Your Discounts

The Omnibus Directive extension records your price history from the day you enable it. Install it before your next campaign, so the 30 days are on record when the discount starts.

Get the extension Read the documentation

Knowledgebase

All familiar Help articles

A list of the most frequently asked questions from the Omnibus Directive extension for Magento 2. We've tried our best to help you with the installation, configuration and troubleshooting. If you do not find the answer you were looking for, you can always send us a message through this form.

Installation articles

Configuration

Quality

Approved, Compatible and Tested

Adobe Commerce Marketplace Approved

This extension is listed on the official Adobe Commerce Marketplace and has passed their review process for code quality, performance and security.

Adobe Marketplace approval means the extension follows Magento coding standards and integrates properly with the platform. Updates go through the same review process.

Hyvä Compatible Plugin

This extension includes full support for Hyva Themes. All frontend components, widgets and templates work natively with Hyva's Alpine.js and Tailwind CSS stack.

The extension works out of the box on Hyva and is tested with every new Hyva release to ensure continued compatibility.

GraphQL Made Ready

This extension exposes its data and configuration through Magento's GraphQL API. You can query and mutate data directly from headless frontends or custom applications.

The GraphQL schema follows Magento's conventions and covers all key functionality of the extension. This makes it ready for PWA Studio, Vue Storefront or any other headless setup.

Magento Cloud Support

This extension is fully compatible with Adobe Commerce Cloud (Magento Cloud). It works with the read-only filesystem, the build and deploy pipeline and cloud-specific caching layers.

No additional configuration or workarounds are needed for cloud environments. The extension handles static content deployment and config management the same way as on-premise installations.

Private Composer Repo

After purchase you get access to a private Composer repository with personal credentials. Install and update the extension with a single composer command, just like any other dependency.

Your Composer credentials are available in your account dashboard. Updates are published to the repository as soon as a new version is released, so you always have access to the latest version.

star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025