Donation widgets allow people to donate directly from your page through a popup window that appears after clicking the donate button. This gives your donors a quick way to give straight from your website
Here is a video walkthrough on how to create a donation widget. A written version of the video is included below.
Creating A Donation Widget
To start you will want to go to the Online Donations Forms. To get here click on ‘Online Donations‘ tab in the ‘Donations‘ section, then click Online Donation Forms. From here you’ll be able to create a donation widget by clicking the green + button and then New Donation Widget button.
The lefthand side will be information for the widget that you will fill out, and the righthand side will show a preview of what the donation window will look like once completed.
Choose a name for your widget to get started. (the field at the top of the lefthand side), and add a brief description. This part won’t be visible to donors, but will be the widget name that appears in your Online Forms page in Aplos. Below the name are three tabs labeled ‘Donation‘, ‘Donor‘, and ‘Payment‘. You can start with the Donation tab.
Donation Amounts Setup
Here you can provide your own donation amounts for your donors to give. The ‘Default’ checkboxes will let you choose which amount will be the default option. You can also edit the existing amounts given; simply click the pencil icon beside the red trashcan (which removes amounts) for any option you wish to change. You’ll also be able to add additional amounts if you would like more than three. After you choose which amounts to provide you can move to additional options below. You have the ability to include descriptions of each donation amount, if you’d like donors to create custom amounts, and allow for one time donations, or recurring donations.
If you would like the option for donors to donate to a specific purpose, then you can add and remove purposes too. Having at least one purpose is required, and all donations will default to this one purpose. Below the Purposes box are additional options to include in the widget. You can enable the option for donors to be able to pay for the transaction fee associated with online donations, or you can let donors have the option to leave a customizable note along with their donation. If you haven’t setup your purposes yet, you will want to check out this resource to help get you started. How to Use Purposes in Aplos
Selecting Required Donor Information
The ‘Donor‘ tab relates to customizing what information you wish to collect about your donors. This will require them to fill out certain boxes before finalizing their donation, whether that by their first name, last name, email, etc.
The three options mentioned are the minimum required and cannot be deleted. You can also add other fields for them to fill out like your own custom fields, which can be left optional by keeping the ‘Required’ checkbox blank. Click the red trashcan to delete additional fields you have added. You will see an option to ‘Add Full Address’ at the bottom, which will give donors the ability to include their address on the donation.
The last tab called ‘Payment’ allows you to choose which payment options you would like donors to use when donating. They can either donate by credit card or by ACH. You can choose to have one or both of these available as options. You will want to setup your merchant account before activating your donation widget. To learn how to setup your merchant account, check out our AplosPay Setup Guide
Afterward, click the ‘Save’ button on the top righthand side above the preview window to save your work. Any saved widgets will appear under the ‘Donation Widgets’ list. You can always make changes to your widgets by clicking on the Actions icon on the far right side of the widget. The Actions icon will also let you add the widget to your website page, disable the widget, or delete it entirely.
Adding a Donation Widget to Donor’s My Aplos Portal
Donors who have given to your organization before can donate again directly in their My Aplos Portal. To accomplish this your organization will need to provide a donation widget to be displayed in their My Aplos. This will allow donors to quickly give again to your organization. To display your widget in My Aplos, locate the Donation Widgets list at the bottom of the Online Donation Form page. Pick one of the widgets you have already created and click the ‘Actions’ symbol on the far right side. From here, click ‘Show in My Aplos’. This will provide the donor a tool to easily access the widget and give. You can always disable this function by following the same action and click ‘Hide in My Aplos’.
Adding a Donation Widget to Your Website
Once you are on the Online Donations Forms page. Locate the Donation Widgets list at the bottom of the page. Pick one of the widgets you have already created and click the ‘Actions’ symbol on the far right side. From here, click ‘Add to My Page’.
The following page will provide you with two options regarding donation buttons; the first option will visually replicate the look of existing buttons on your website. The second option will provide you with buttons designed by Aplos. If you would like to use one of Aplos’s buttons, simply click on a button you like, and a code for that button will be generated in the field below. Click on the ‘Copy To Clipboard’ button below the field.
Return to the page you wish to add the button to. Make sure you’re in the page edit tool.
- All Plans
To set your donation widget on your Aplos website, you’ll first want to view and edit the page you wish to add the widget. Next, locate and select a content block on your site that will hold your widget. Once selected, an “+” button will appear below. Click “+” and a drop-down menu will appear, click “More” then select the “HTML, JS, CSS” code block. Finally, on the code block click, “Settings” and paste the donation widget code and click “OK“.
- Business Plan
- eCommerce Plan
In WordPress, there are two ways to view your edit page once in the edit tool. These are tabs labeled ‘Visual‘ and ‘Text‘ on the top right corner of the edit field. Normally, you would make edits through the default ‘Visual‘ version, but copying and pasting the button code into ‘Visual‘ won’t work, so you will have to go into the ‘Text’ tab. This tab will display what is written in the article along with the HTML code for the page. This may look confusing if you’re unaccustomed to seeing HTML code, but simply search for the place on the page where you want the button, then use the paste tool to paste the button code you already copied.
Once you update or publish the page, the button will appear in your article. Click on it to see the widget popup that will ask for donations.
- Business Plan
- Commerce Plan
In Squarespace, when editing your page you will want want to add your donation widget using the Code Block tool. This is found in the Content Block Menu on the top right corner of the page you are editing. Select the Code Block and place it on your page. From there, copy and paste the widget code into the block and select “Apply“. Once you publish the page, the button will appear on your page. For more information on Code Blocks check out Squarespace’s resources on Code Blocks
- All Plans
In Weebly, to add a donation widget to your page you will want to edit the page you wish to place the widget on. From there, select content blocks menu and drag an “Embed Code” block to where you would like it on the page. Click on the block and select the “Edit Custom HTML” option. Paste the copied code into the block and save. For more information on “Embed Code Blocks check out Weebly’s Embed Code guide
- Not Available