Wo WooCommerce Beginner

Carbon Footprint + Offset Checkout — Complete guide

Install and run version 2.0: setup assistant, contribution amount, projects and transfers, emission factors and method, product data, display, customer texts and wording checker, block checkout, ledger, transparency page, migration from 1.x and developer tools.

Updated Module version 2.0.0

Overview

DataFirefly Climate Contribution estimates the greenhouse gas emissions of your WooCommerce products and lets customers add a contribution to climate projects at checkout. Every contribution is recorded in a ledger that follows the order, every transfer to a project is kept with its proof, and a transparency page shows customers what is collected, where it goes and how it is calculated.

Version 2.0 adds the block checkout, the ledger, projects and transfers, a setup assistant, a dashboard, editable emission factors with their sources, a wording checker in eight languages and a “Climate contributions” tab in My account.

DataFirefly Climate Contribution – Dashboard: amounts collected and transferred, participation, monthly chart, product data and wording check
Dashboard: amounts collected and transferred, participation, monthly chart, product data and wording check

In short: install, follow the setup assistant, check the emission factors you use in Climate > Method & factors, publish the transparency page, then record each transfer to your project with its proof.

Installation and update

  1. In Plugins > Add New Plugin > Upload Plugin, choose df-carbon-offset-2.0.0.zip, then activate DataFirefly Carbon Footprint & Climate Contribution.
  2. The setup assistant opens. You can come back to it at any time with the Setup assistant button of the Climate menu.

Requirements: WordPress 6.4 or later, WooCommerce 8.2 or later, PHP 7.4 to 8.5. The plugin is compatible with HPOS and with the Cart and Checkout blocks.

Updating from 1.x: upload the new zip and choose Replace current with uploaded. Settings, factors, category mapping and contributions are kept; the Climatiq key is moved to a protected option; a project is created from your former “provider” so that you can complete it. Contributions charged through the block checkout with 1.x but never recorded are found and added to the ledger.

Setup assistant

Five short steps:

  1. Contribution — how the amount is calculated (see below) and the minimum.
  2. Project — the project that receives the contributions: name, partner, type, standard, country, public registry link and description.
  3. Product data — an emission factor for each product category, pre-selected from the category names.
  4. Display — estimated emissions on product pages, data quality threshold, style, My account tab.
  5. Transparency — creates the transparency page as a draft and shows what is left to do before going live.
DataFirefly Climate Contribution – Setup assistant in five steps: amount, project, product data, display, transparency
Setup assistant in five steps: amount, project, product data, display, transparency

The contribution at checkout

The option appears in the order summary of the block checkout, or above the payment methods of the classic checkout (and optionally on the cart page). It is never pre-selected and is asked again for every order. When the customer ticks it, a Climate contribution line is added to the order; unticking it removes the line. “How is it calculated?” shows the formula, the project and a link to the transparency page.

DataFirefly Climate Contribution – Opt-in contribution to climate projects in the WooCommerce block checkout
Opt-in contribution to climate projects in the WooCommerce block checkout

Choose how the amount is calculated in Climate > Settings > Contribution:

  • From the estimated emissions — emissions of the order × price per tonne. Use the price actually charged by your partner, so that the amount matches what is funded.
  • Fixed amount — the same amount for every order.
  • Round up — the order total rounded up to the next 1, 2, 5 or 10.
  • Percentage — a share of the products total.

Minimum, maximum and rounding (0.01 to 1) apply to the first, second and fourth modes. The contribution is not taxable by default; you can make it taxable with the tax class of your choice, the amount shown to the customer then includes tax. The tax treatment depends on your country and on how you pass the money on: ask your accountant.

DataFirefly Climate Contribution – Contribution settings: four ways to calculate the amount, with a live preview
Contribution settings: four ways to calculate the amount, with a live preview

The preview on the right updates as you type, with an example order.

After payment, the customer sees a thank-you message, the contribution in the order e-mails and the Climate contributions tab of My account.

DataFirefly Climate Contribution – My account: the customer’s climate contributions
My account: the customer’s climate contributions

Projects and transfers

In Climate > Projects & transfers, describe each project you fund. Customers see the project at checkout and on the transparency page, so stick to verifiable facts: who runs it, under which standard (Gold Standard, Verra VCS, Label Bas-Carbone, Puro.earth…), where, and the link to its entry in a public registry. One project receives the new contributions; the others can stay active for display or be deactivated.

Each time you pay a project, click Record a transfer: date, amount and currency, the certified tonnes stated on the partner’s certificate (optional), the reference and a link to the proof. The panel shows, per currency, what was collected, what was transferred and what is left to transfer.

DataFirefly Climate Contribution – Supported projects and transfers to the projects with their proofs
Supported projects and transfers to the projects with their proofs

The plugin does not buy carbon credits. It collects the contributions with the orders. Transfer the amounts to your project and record each transfer: that is the proof your customers can check.

Emission estimates and method

For each product, the estimate is:

production = weight (kg) × factor of the category    (or factor per item, or value of the product)
delivery   = weight (t) × distance (km) × transport factor (kg CO₂e / t·km)
estimate   = production + delivery

The factor is taken, in this order, from the value entered on the variation or the product (with its source), from the factor chosen on the product, from the factor of the product category (variations use the categories of their product), or from the generic factor if you allow it. A factor per litre needs the volume entered on the product.

DataFirefly Climate Contribution – Method and emission factors: formula, factor per product category and data quality
Method and emission factors: formula, factor per product category and data quality

In the Emission factors tab, each factor has a value, a basis (per kg, per item, per litre, per tonne-kilometre), a source, a reference, a link and a year. The default values are indicative orders of magnitude. Compare the factors you use with a published source — for example the ADEME Base Empreinte or your suppliers’ life cycle assessments — fill in the reference and tick I checked this value against the source above. With a Climatiq key (Settings > Data & API), you can import the value of a factor from its activity ID; you still check it before use.

The Products to check tab lists the products without estimate (no weight, no factor) or whose estimate is not good enough to be shown.

Delivery: in Settings > Delivery, set the average distance, the transport mode and, optionally, a distance per shipping zone.

What customers see on product pages

The estimated emissions per item appear in a neutral block (card, line or text only), with “How is this estimated?” that shows the factor, the source, the delivery assumption and the data quality. An optional comparison with a car journey uses the ADEME Impact CO2 factor (0.142 kg CO₂e per km by default).

DataFirefly Climate Contribution – Product page: estimated emissions with the method and the data quality
Product page: estimated emissions with the method and the data quality

The estimate is only shown when its data quality reaches the threshold of Settings > Display — by default, a checked factor or a value entered for the product. You can hide the block on a product (Climate tab of the product) or place it yourself with the Product estimated emissions block or the [dfcarbon_badge] shortcode.

Customer texts and wording checker

In Settings > Customer texts, you can change the title and the checkbox text of the option, the transparency note, the name of the order line, the thank-you message and the title of the product block. Leave a field empty to keep the default text, translated into the language of each customer. With Polylang or WPML, your texts are registered for translation.

Each text, and each project name and description, is checked as you type in eight languages:

  • Not allowed — claims that a product has a neutral, reduced or positive impact because of offsetting (“carbon neutral”, “we offset your footprint”, “net zero delivery”…), banned in the EU since 27 September 2026.
  • To substantiate — generic claims (“eco-friendly”, “green choice”…) that require recognised excellent environmental performance.
  • Label — wording that looks like a home-made sustainability label.
DataFirefly Climate Contribution – Wording checker: a banned claim flagged as you type (EU Directive 2024/825)
Wording checker: a banned claim flagged as you type (EU Directive 2024/825)

The checker helps you write precisely; it is not legal advice. Have your texts checked by a lawyer, especially in France where the transposition of Directive (EU) 2024/825 was still under discussion in November 2026.

Dashboard and ledger

The dashboard shows the amounts collected (confirmed contributions, net of refunds) and awaiting payment, what is left to transfer, the number and average of contributions, the participation rate over 30 days, the certified tonnes stated on your transfer proofs, a monthly chart with its data table, the product data coverage, the wording check and a setup checklist.

In Climate > Contributions, the ledger lists each contribution with its order, amount, refunds, estimated emissions, data quality, project and status: Awaiting payment, Confirmed, Cancelled, Refunded or Removed from the order. It follows the order automatically, including partial refunds of the contribution line. Filter by status, project, dates or order number and export to CSV.

DataFirefly Climate Contribution – Contributions ledger with payment, cancellation and refund status, CSV export
Contributions ledger with payment, cancellation and refund status, CSV export

Transparency page, blocks and shortcodes

The assistant creates a page with two blocks: Climate contributions report (amounts collected and transferred, projects, transfers with proofs) and Emissions calculation method (formula, contribution, factors in use and their sources). Review it, publish it, and select it in Settings > Display: the checkout, the product block, the thank-you message and My account link to it.

DataFirefly Climate Contribution – Transparency page: amounts collected and transferred, projects, transfers and method
Transparency page: amounts collected and transferred, projects, transfers and method
  • [dfcarbon_impact figures="yes" projects="yes" transfers="yes"] — transparency report.
  • [dfcarbon_methodology] — calculation method.
  • [dfcarbon_badge id="123" style="card"] — estimated emissions of a product (card, inline or minimal).
  • [dfcarbon_projects], [dfcarbon_cart_summary] and [dfcarbon_stats] (figures only, kept from 1.x).
DataFirefly Climate Contribution – Contribution option in the checkout on a phone
Contribution option in the checkout on a phone

Developers

  • REST API: GET /wp-json/dfcarbon/v1/impact (public figures, no personal data), GET /dfcarbon/v1/products/<id>/footprint (only displayable estimates), GET /dfcarbon/v1/contributions and POST /dfcarbon/v1/check-text (shop managers).
  • WP-CLI: wp dfcarbon status, wp dfcarbon product <id>, wp dfcarbon sync <order>, wp dfcarbon reconcile, wp dfcarbon check-text "<text>".
  • Filters: dfcarbon_product_footprint, dfcarbon_contribution_amount, dfcarbon_convert_amount (multi-currency), dfcarbon_capability, dfcarbon_template.
  • Templates: copy a file of templates/ to yourtheme/df-carbon-offset/.
  • Site Health test, personal data exporter and a suggested privacy policy text are included.

Uninstall

Deleting the plugin keeps all data unless you tick Delete all data when the plugin is deleted in Settings > Data & API. In that case the ledger, transfers, factors, projects, settings and plugin metadata are removed on every site of the network. Export the ledger first: it justifies the amounts collected. Contribution lines always stay in the orders.

FAQ

Can I say that my orders are carbon neutral?

No. In the EU, offsetting-based claims that a product has a neutral, reduced or positive impact are banned since 27 September 2026. Present your support to the projects instead, with verifiable facts.

Why are the estimates not shown on my product pages?

Their data quality is below the threshold of Settings > Display. Check the factors you use against a source and mark them as checked, or enter a value for the product. Method & factors > Products to check lists the products concerned.

The option does not appear at checkout.

Check that the contribution is enabled and offered on the checkout page (Settings > Contribution). In “From the estimated emissions” mode, the cart needs at least one physical product with an estimate; virtual products have none.

Does it work with multi-currency plugins?

The amount is calculated in the shop currency and converted with WPML multi-currency or the dfcarbon_convert_amount filter. The ledger and the reports keep each currency apart.

Was this page helpful?

Still stuck? Contact support