Configuration
Open Add-ons > Manage add-ons > Green Claims Checker > Settings.
General
Section titled “General”| Setting | Default | What it does |
|---|---|---|
| Pages and cron | Link to Products > Green claims, the cron command and the cron URL with your key. | |
| Check products when they are saved | On | A product saved in the admin or vendor panel is checked at once (up to five per request; more are queued). Off: only Scan now and the cron job check products, and vendor moderation is paused. |
| Fields to check | all | Product name, short description, full description, promo text, page title, meta description, meta keywords, search words, product features, tags (Tags add-on), SEO name (SEO add-on). |
| Lower the severity when a figure follows in the same sentence | On | When the sentence of a match contains a figure with a unit (“70 %”, “120 g”, “2 kWh”, “CO2e”), the finding is one level lower and marked figure nearby. A claim is not generic when its specification is given in clear and prominent terms on the same medium (Directive (EU) 2024/825, recital 9); the add-on cannot judge that, so it only flags the case for your review. |
| Show a notice after an administrator saves a product with findings | On | A warning with the matched words after saving a product in the admin panel. |
| Full scan by cron | Weekly | Daily, Weekly or Off. The cron job starts a full scan when the last one is older than this. |
| Products per batch | 200 | 20 to 1000 products per batch of Scan now and the cron. Lower it on slow servers. |
Vendor moderation (Multi-Vendor)
Section titled “Vendor moderation (Multi-Vendor)”| Setting | Default | What it does |
|---|---|---|
| When a vendor saves a product with findings | Warn the vendor | Do nothing; Warn the vendor (a notice with the matched words); Require review (a product with findings at or above the hold severity is switched to Disabled and waits in Green claims > Vendor submissions; fixing the text lifts the hold); Block (the product cannot be switched to Active or Hidden while such findings are open). |
| Hold from severity | High | High or Medium and high. Low findings never hold a product. |
| Vendors see their findings | On | Vendors get Products > Green claims for their own products. Under Require review or Block, the product tab is shown to vendors either way. |
Administrators are never moderated. An administrator who activates a held vendor product (in the product editor or in the product list) lifts the hold.
With the core Vendor data premoderation add-on. When premoderation is on, a vendor’s change already sends the product to “Requires approval”. Require review then also lists the product in Green claims > Vendor submissions so you see the findings before you approve it. Block only warns the vendor in this case, because the product is not active: if you approve the product in the core premoderation, it becomes active with its open findings. Check the Green claims tab of the product before you approve it, or use Require review.
The moderation applies when a vendor saves a product in the vendor panel or changes its status in the product list. Products a vendor imports by CSV are queued and checked by the cron job; they are not held automatically.
Term lists
Section titled “Term lists”Products > Green claims > Term lists.
- Matching. Case-insensitive, whole words, with or without spaces, hyphens, slashes or dots between the words: “eco-friendly”, “eco friendly” and “ecofriendly” are the same term. A
*at the start or end of a term matches any letters, for examplesustainab*orumweltfreundlich*. HTML tags and attributes are ignored; entities such as are decoded; “CO₂” matches “co2”. - Language. Terms for All languages are checked in the texts of every active language (the English defaults are like this, because English marketing words are common in other languages too). A term for one language is checked only in the texts of that language.
- Rule category decides the legal reference and explanation shown with the finding: Generic environmental claim (UCPD Annex I point 4a), Offsetting-based claim (4c), Sustainability label (2a), Whole product claim (4b), Future performance claim (Article 6(2)(d)), Legal requirement as a feature (10a, empty by default: add requirements that the law imposes on all products of your categories), Custom term.
- Severity: High, Medium or Low. The defaults are High for the examples named in the Directive and for offsetting claims, Low for words that are often a colour or a mode name (“green”, “eco”).
- Suggestion: the neutral-wording hint shown with each finding.
- Edit a term by clicking it; Enable / Disable / Delete selected terms. Disabling or deleting a term removes its findings.
- Import / export CSV with the columns
term, language, category, severity, suggestion(header optional, comma or semicolon). Existing terms are skipped. - Restore defaults adds default terms and allow-list entries you deleted; your other changes stay.
Changes apply to products checked afterwards; run Scan now to apply them to the whole catalog.
Allow-list
Section titled “Allow-list”Products > Green claims > Allow-list. A matched term inside an allow-list phrase is reported differently:
| Type | Effect | Example |
|---|---|---|
| Recognised label (certification scheme or public authority) | Shown as Recognised (not counted as an open finding) with the scheme and evidence. | EU Ecolabel (pre-filled, Regulation (EC) No 66/2010), your certified label |
| Recognised excellent environmental performance | Same as above. | “energy label class A” |
| Context (not an environmental claim) | The match is dropped. | “green tea”, “dark green”, “eco mode” (pre-filled) |
Keep the licence or registration number and the certificate link in Evidence and set Valid until: expired entries stop applying, and entries without evidence are marked. The allow-list applies to the whole catalog; a label on the list does not prove that a particular product holds that label, so keep the per-product evidence as well (accept the finding with evidence when you need a record per product).
Licence
Section titled “Licence”Enter your Kavio Labs licence key under Settings > License and click Check now (Marketplace buyers can use the Marketplace licence number in Add-ons > Manage). Without an active licence, existing findings, the lists and the CSV export stay available; scans, checks on save, replacements and the vendor moderation are paused.