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 Subscriptions

Configuring My Subscriptions

Get the My Subscriptions widget up and running to help people stay connected.

See Quick Start to get started. 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

This widget does not require any attributes. It's ready to go!

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

Your publications must meet the following criteria to display in the My Subscriptions widget:

  • Available Online: All publications where the Available Online field is set to Yes will display.
  • Online Sort Order: Publications with an online sort order display at the top of the list in ascending order. Publications without an online sort order display below and are sorted alphabetically by publication title.
  • Title/Description: Publications can indicate their target audience in the title or description, but nothing prevents anyone from subscribing to any available publication.
Tip: Attach a compelling image to the publication record to get people excited about it! If there is no image, a stock image will display. File formats supported by both browsers and MinistryPlatform are: .bmp, .gif, .jpg., and .png. The widget software will crop and focus on the center of the image according to an ideal ratio of 59:32.

Customization

Want to make sure the buttons and checkboxes match your church's branding? Customize your widgets!

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: You can customize what displays when a publication doesn't have a description. 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-subscriptions.noDescriptionText: The text that displays for any publication without a description. The default is "Check the box to subscribe."
  • mpp-subscriptions.updateButtonText: The text that displays on the button. The default is "Update Subscriptions."
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: