Skip to content

Magento 2 Donations Suite Manual

Donations Suite Cover


Magento 2 Donations Suite is the extension that makes it possible to accept online donations and support non-profits and charities you care about. Out of the box, Magento 2 doesn’t allow to add such order surcharges.

Requirements and installation

Donations Suite supports Open source (Community), Commerce (Enterprise) editions and Commerce cloud. The current version of the Magento installed on your website can be found in the lower right corner of any backend page.

Donations Suite has 3 separate ways of installation:

1) Copy the code (ready-to-paste package);
2) Use MageWorx Repository;
3) Use local Composer.

Extension configuration

Backend setup

The main extension’s settings can be found under STORES ⟶ Configuration ⟶ MAGEWORX ⟶ Donations.

Mageworx Donations Settings Mageworx Donations Settings Mageworx Donations Settings

  • Accept Donations enables / disbales the entire donations functionality in the store.

  • Enable Cart Donations adds the donations box to the shopping cart page. If disabled, the donations functionality will be disabled in the cart page on the front-end. It is possible to add donations via the backend though.

  • Enable donations in Admin Orders enables/disables the possibility to add donations from the backend.

  • Minimum Donation specifies the minimal value of the allowed donations. This will be shown on the frontend as well.


Please bear in mind that this value is for the frontend only. For the orders with donations that are being created in the backend, it won't be counted.

  • Default Description allows to set the default text of the donation box, shown on the front-end.

  • Donation Amount Placeholder sets the placeholder (default text, which is shown inside the input field) for the donation amount field if the custom donation amounts are allowed: Mageworx Donations Settings

  • Default Organization allows you to choose the default charity, which will be pre-selected on the front-end if the charity functionality is enabled.

  • Show Predefined Amounts allows you to add the predefined donation amounts available for your customers. Below this field the store owner can add these values one by one.

  • Enable Donation Custom Amount allows you to enable the feature of custom donation amounts. If enabled, your customers will be able to specify custom donation amounts on the front-end.

  • Predefined amounts allows you to add the predefined donation amounts available for your customers.


This is the way how these settings can be combined to show the donations on the frontend. The predefined amounts are shown in the dropdown menu. If Custom Amount is selected, the client can specify the desired value. The donation placeholder text (Enter your donation in this case) is shown on this box. Mageworx Donations Settings

  • Enable Round Up Donation enables the round-up functionality.


It provides the possibility to add some small donation amounts, calculated as round-up of the order total to the full price. In case the user's subtotal has the decimal part (like $20.40), this setting will allow to add the roundup (60 cents) to the donation.

If the subtotal doesn't have decimal part, the 'round-up' feature will add $1.

The round-up amount is added to the selected charity (if this feature is enabled).

Mageworx Donations Settings

  • Donations RoundUp Message set the message, which is shown near the 'Round-up' check-box on the front-end. You can use the following variables here: %roundupamount% - inputs the rounded amount; %charity% - inputs the selected organization.

  • Enable Gift Aid Donations enables the Gift Aid functionality.

  • Gift Aid confirmation message set the confirmation notice required to be compliant with Gift Aid. See the Gift Aid section for more details.

Track donations

The extension gives you the ability to see all orders with the donations on a single page. To see all orders with donations, go to SALES ⟶ MageWorx Donations ⟶ Donations. The grid has the "Donation amount" and the "Organization" column to display the added donation amount and the selected organization/charity. The orders grid is available for each organization as well.

Manage charities

To add or edit the organization / charities section, go to SALES ⟶ MageWorx Donations ⟶ Organizations.

Mageworx Donations Charity Setup

To add the new Charity, click the Add New Organization button.

Mageworx Donations Charity Setup

Under these settings you can specify the Name of the charity and its Description, upload an Image (logo), define the Sort Order and the Status of this charity.

Name, Description and the Image will be shown on the frontend. The sort order provdes the position of this charity.

The "Orders" section displays all orders with the donations for a certain charity:

Mageworx Donations Charity Setup

Donations for back-end orders

You can also add the donation to the orders, created in the back-end (add the products to the order first):

Mageworx Donations Backend

When added, it will be shown in the order summary

Mageworx Donations Backend

Frontend experience

On frontend, the donations box is shown in the cart side bar. Please check the image below to see how the cart block looks like if all features are enabled:

Mageworx Donations Frontend Cart

Themes compatibility

The extension is compatible with Magento 2 Luma, Porto and Ultimo themes by default. If you have any issues with compatibility with any other 3rd party themes, please drop us a line and we will be happy to assist.

Gift Aid

Gift Aid is a tax relief allowing UK charities to reclaim an extra 25% in tax on every eligible donation made by a UK taxpayer. See more details on JustGiving and on

The Donations Suite extension allows you to collect the donataions compliant with Gift Aid. You can enable the Gift Aid feature in the extension configuration. See the Back-end setup section.

Once the Gift Aid is enabled, the "Gift Aid" check-box will appear on the front-end. If your customers will choose it, they will have to select another check-box to confirm they are UK taxpayers. Once it is confirmed, the new field to enter their UK address will appear.

All these details are stored in the order and you can see these columns in Magento 2 native orders grid (Sales ⟶ Orders).

These columns are also added to the orders export feature in order to easily export all orders with Gift Aid.

Got Questions?

MageWorx offers FREE lifetime support and updates for any extension developed for Magento. Need help with the extensions? Feel free submit a ticket from our Support page. 

MageWorx offers outstanding services developing custom-tailored solutions for Magento platform to attain your eCommerce objectives. Our professional impassioned team provides profound and custom oriented development of your project in a short timeframe.