What would you like to know more about?

Show Page Sections

Configuring My Giving

Set up the My Giving widget.

Help people visualize their giving. See the Quick Start Guide for tips on getting the My Giving Widget up and running.

If the shared script hasn't been added to your website, add it to the appropriate webpage, replacing "YOUR-BASE-MP-URL" with the base URL with your base MinistryPlatform URL.

<script id="MPWidgets" src="https://YOUR-BASE-MP-URL.com/widgets/dist/MPWidgets.js"></script>

Create or identify a page on your website where you want to display the widget. To add this widget to your church website, add the code you generate in the Widget Configurator widget (with the required attributes) in the body of your chosen website page.

Tip: While not mandatory, this snippet would typically be placed inside a <div> element with the class "container".

Widget Configuration

Required Attributes

Hide Soft Credits
This determines whether the option to view soft credit donations displays to the person logged in. The default is false.
  • Attribute: hidesoftcredits
  • Valid Value: false (or empty) or true
  • Example:
    hidesoftcredits="false"
Note: This widget is only available to users who have authenticated via the Login Widget. New users have the opportunity to create an account through the Login flow. If needed, the page containing this widget could be added as a navigation item in the Login menu, making it available only after authentication. See Login Configuration for information about extending the drop-down menu.

Configure Your Widget

Use the Widget Configurator widget to configure your widget:
  1. Go to your Widgets Library by appending "/widgets" to your system domain. For example, https://example-church.ministryplatform.net/widgets.
  2. Click the Navigate to... drop-down menu, and select Widget Configurator.
  3. Select the widget you want to configure, then customize your widget.
  4. Click Try it Out to see what your widget will look like!
  5. Copy the generated code from the Embed Code box.
  6. Add the code to the designated page on your website.

Platform Configuration

  • Donations display from four years prior through the current day. Future donations will not display.
  • The My Giving widget will not display the value of a donation if the Omit Amount on Statement field is set to Yes. The donation description itself will still be listed, but the value will be blank.
  • If there are two heads of household and both have their Statement Type set to Family, a spouse label displays next to donations made by the spouse of the person logged in.

Customization

Customize the My Giving widget to change button colors, update labels, and more to match your church brand.

CSS: Every widget accepts the Custom CSS attribute. Include it before the closing of the opening widget tag to customize backgrounds, button colors, and more!

Application Labels: Want to change the soft credit donation disclaimer? To make changes, go to System Setup > Application Labels and update the appropriate label(s). Note that you are responsible for all translations if the default is not used.

  • mpp-my-giving.byProgram: The doughnut chart label. The default is "By Program".
  • mpp-my-giving.offeringsLabel: The tithes and offerings giving label. The default is "Tithes/Offerings".
  • mpp-my-giving.softDonationsSubtitle: The soft credit donation subtitle. The default is "Soft Credit Donations will not appear on your tax statement as they were given by another entity at your request".