home

MinistryPlatform

RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center
RealmMinistryPlatformPDSACSAccountingGivingConnectShepherdGrowth MethodGo MethodMissionInsiteGatherHeadMaster ChildcareTrust Center

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

My Household

Configuring My Household

Set up the My Household widget.

Want to let people see and update their own information? See the Quick Start Guide to get the My Households 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 Add Household Member
This determines whether the Add Household Member option is available. If available, heads of household can add new household members (for example, if this family recently had a child). The default is false.
  • Attribute: hideaddhouseholdmember
  • Valid Value: true or false
  • Example: 
    hideaddhouseholdmember="false"
The widget URL must be authorized in your Google Maps API Key. See Google Maps API Key for more details. You must:
  • Determine any URLs you will use for this widget (unique domains).
  • Authorize the URLs in the Google Maps API Key.
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

The My Household widget only displays contacts whose contact status ID is a value other than 3 (deceased). Deceased members do not display in the widget.

Customization

Customize the My Household 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 customize the My Household widget? Maybe change "Select Campus" to say "Select Congregation"? 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-household.congregationLabel: The label for the Congregation drop-down filter. The default is "Select Campus".
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: