Gatemi Price History Settings Reference

The screen is WooCommerce → Price History (capability manage_woocommerce). Both editions store their settings in one option, gmph_settings. The free edition has one setting of its own; saving there keeps the full edition's keys in the option without reading them.

What a shopper sees

Show the lowest price beside every reduced price

  • Key: enabled · Default: on (yes)
  • Off, no reference line is printed anywhere and (full edition) no chart is drawn. Prices are still recorded while it is off, so the history is complete when you switch it back on.
  • It is on by default because a compliance plugin that installs switched off is a month of non-compliance.

Your own wording — Full edition

  • Key: wording · Default: empty, shown as "Lowest price in the last {days} days: {price}"
  • Use {days} for the number of days and {price} for the figure. Several member states prescribe the phrasing; type the one you were given. The price is formatted by WooCommerce in your shop's currency format.
  • A % sign in your wording is printed as it is ("up to 50% off" is fine).
  • Free edition: the sentence is fixed — "Lowest price in the last 30 days: …" — and translated with the plugin.

Draw a small chart of the recorded prices — Full edition

  • Key: chart · Default: off (no)
  • Draws a small line chart of the recorded prices of the window under the product summary on the product page. It needs at least one recorded price besides the current one. For a variable product it charts the cheapest variation.

The window, per country — Full edition

Countries that count a different number of days

  • Key: windows · Default: empty
  • One per line: a two-letter country code, a colon (or =), and a number of days from 1 to 365. Commas and semicolons also separate entries.
FR: 30
IT: 30
PL: 30
  • Every country not listed uses 30 days, the Directive's figure.
  • The shopper's country is read from their shipping address, then their billing address, then your store's base country (WooCommerce → Settings → General).
  • An unreadable line is ignored.
  • Free edition: the window is always 30 days.

Exemptions — Full edition

These are not on the settings screen but on products and categories.

On a product

Product data → General → Reference price (meta key _gmph_exempt):

Choice Stored What happens
Lowest price of the window (the rule) (nothing) The normal reference line
Introductory price — nothing announced introductory No line, because there is no prior price
Progressive reduction — measured before the first cut progressive The reference is the lowest price before the first cut, so the second cut is not measured against the first

A variation follows its product's choice.

On a product category

Products → Categories → Edit: tick Exempt every product in this category from the lowest-price line (term meta _gmph_exempt = yes). For goods liable to deteriorate or expire rapidly, which the Directive leaves out. Products filed under an exempt category get no line.

The free edition never reads an exemption — it shows the line on every reduced product. An exemption only ever removes a line a shopper would otherwise see, so the free edition does not apply one it cannot show you.

Reductions with no recorded reference — Full edition

A report, not a setting. It checks up to 200 products on WooCommerce's own on-sale list and names every one whose reference is the regular-price fallback — the products for which nothing has been recorded yet. The list empties as the history fills over the first thirty days.

How the history is kept

Not a setting, but shown on both screens:

  • Recorded prices older than the longest window plus 60 days are pruned daily (90 days with the default 30-day window).
  • The latest recorded price of every product is always kept, because it is the price in force.

License & updates — Full edition

Enter the GM-XXXXX-… key from your gatemi.com account and press Activate. If a licence check cannot reach gatemi.com, the licence state is left unchanged. Without a key the plugin makes no external requests.

For developers — Full edition

A table of the filters the plugin applies. See the developer reference.

Shopping Cart
Scroll to Top