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

User Defined Labels

Configuring User Defined Labels

Set up the User Defined Labels widget.

The User Defined Labels widget is baked into your microsite. If you're using a microsite, you can skip the widget setup and see Platform Configuration for your next steps. Or, if you want to use the widget on your website and you haven't configured your site to use widgets yet, see the Quick Start Guide.

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. Ideally, add it with the Language and Locale widget.

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

Widget Configuration

Required Attributes

Label Name
This associates the application label you set up with this widget so it can display on your site.
  • Attribute: name
  • Valid Value: label name you defined in Application Labels, without the prefix "mpp-user-label."
  • Example: If your application label was called "mpp-user-label.SampleLabel", your label name would look like this:
    name="SampleLabel"

Optional Attributes

Bare Text
This determines whether to include CSS selectors or just a text object for your label.
  • Attribute: bare
  • Valid Value: true or false; if true, the label will just display bare text with no extra markup or CSS applied
  • Example:
    bare="true"

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

  • You must be a system administrator to do this.

Set up each application label you want the User Defined Labels widget to display on your site.

  1. In the navigation menu, click System Setup > Application Labels.
  2. Click New Application Label.
  3. For API Client, select TM.Widgets.
  4. For Label Name, enter mpp-user-label. and the label name you want. Do not add any spaces or special characters.
    If you're setting up a label called "Welcome Message", label name would look like this: mpp-user-label.WelcomeMessage
  5. For each language, enter the translated text that should display depending on the person's selected language (if used with the Language and Local widget).
  6. Click Save.

You can now add your label to the Widget Configuration.

Image of an example of the application label record showing "Label Name" as "mpp-user-label.WelcomeMessage" with translations of the message "Welcome to our church!"

Once you add your label in the widget, you can place the widget code on your website where you want that label to display. Then, depending on which language a person has selected, they'll see the translated text.

Customization

Customize the User Defined Labels widget 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!

The following CSS selectors are available:
  • #mppw-user-label: Use to select the label by its ID.
  • .mppw-component-container: This class is used in several widgets.
  • .mppw-user-label: Use this to style all user-defined labels on the page in the same way.
  • .mppw- appended with the label name (without any spaces or special characters): Use this to style the individual user-defined label.
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: