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

Prayer & Feedback

Configuring Prayer & Feedback

Configure the Prayer & Feedback widget so people can submit prayer requests and feedback through your website.

See the Quick Start Guide for tips on getting the Prayer & Feedback 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

Return URL
The URL where the Prayer & Feedback widget lives on your website. This required attribute facilitates the verification step.
  • Attribute: returnurl
  • Valid Value: A fully qualified URL. The verification token uses this URL to direct the person back to the widget, so it cannot be relative.
  • Example: 
    returnurl="https://example-church.com/prayer"
Email Template ID
The message stored in MinistryPlatform that will be sent to the person who submits a prayer & feedback response.
  • Attribute: verificationemailtemplate
  • Valid Value: Message ID
    Tip: This attribute uses a Message ID to send the email. If you don't see your message in the list, you'll need to mark the message to show as an option. If you want to use an existing template, you'll need to convert it to a message first.
  • Example: 
    verificationemailtemplate="141"

Optional Attributes

Program ID
If included, prayer & feedback responses are associated with the selected program.
  • Attribute: programid
  • Valid Value: A single program ID
  • Example: 
    programid="3"
Feedback Type ID
Determines which prayer & feedback types are available in the Feedback Type drop-down menu.
Note: There are four feedback types: Prayer, praise report, comment, and raving fan. You can mix and match them into different versions of your widget. You could have one widget for each type, or combine prayer and praise report into the same widget.
  • Attribute: feedbacktypeids
  • Valid Value: One or more feedback type IDs, separated by a comma.
  • Examples: 
    feedbacktypeids="1"
    feedbacktypeids="1,2"

Attributes must be included before the opening widget tag is closed. Attributes may be listed in any order and should be separated by a space or other whitespace. An attribute's value should be wrapped in quotation marks.

<mpp-prayer-feedback-form returnurl="https://example-church.com/prayer" verificationemailtemplate="141" programid="3" feedbacktypeids="1,2"></mpp-prayer-feedback-form>

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

Program: Select the program that fits the prayer and/or feedback you'll receive.

Verification Email Template: The Prayer & Feedback widget is a two-step widget, and this message requires a verification token for people to continue the form. Because there are no records for this person in MinistryPlatform, you can't use contact merge fields. You can personalize this message using optional tokens.

  • Required: [mpp_verify_email_url] (expires in 24 hours) should be set somewhere in your email. Use the source view to set this link. For example, the link text that displays might be "click here" or "verify".
  • Supported Merge Fields: [mpp_contact_first_name], [mpp_contact_last_name]
<div>tap here to <a href="[mpp_verify_email_url]">verify</a></div>
Tip: Make the verification message's from contact, reply to contact, and subject line very obvious so people can easily identify it in their inbox. You can also include merge fields in your subject line to personalize your message.

Mark a Message to Show as an Option

When configuring your widgets, there are fields where you can select an email template. To keep the list manageable, the messages that display as options must be marked as templates.

If the message you want does not display in the Widget Configurator, you can mark it as a template on the message record. (The Template field is hidden by default through System Setup > Field Management, so you'll need to unhide it first.)

  1. Confirm that the message you want is not an option in the Widget Configurator.
  2. In the navigation menu, click System Setup > Field Management.
  3. In the Field Name column, search for Template.
  4. In the Page column, search for Messages.
  5. Open the record, and click Edit Record.
  6. In the Hidden field, select No.
  7. Click Save.
  8. In the navigation menu, click Communications > Messages.
  9. Open the message you want to display as an option in the Widget Configurator, and click Edit Record.
  10. In the Template, select Yes.
  11. Click Save.
  12. Refresh the Widget Configurator if you had it open in your browser .

You can now select this message as an option when you configure the widget.

Convert a Template to a Message

Widgets use message IDs, not template IDs. You can use the Template Editor Tool to create the template you want, but you must turn the template into a message and use that ID in the widget. Here's how!

  1. Create and save your template using the Template Editor Tool. Make sure you can access the template.
  2. Open the New Message Tool, click Insert > Templates, and select your newly created template from the list. Click Send > Save as Draft.
  3. In the navigation menu, click Communications > Messages.
  4. Open the draft you just created.
  5. Click the subject line to open the message record. The Message ID is listed under the subject line.
  6. Use this ID for the Template ID attribute value when you configure the widget.

Customization

Customize the Prayer & Feedback widget with CSS and application labels.

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 the Submit button to say "Request Prayer" when you limit the feedback type to a prayer request? Want to add, "We'll be praying for you!" to the message people receive after they verify their submission? No problem! 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-prayer-feedback-form.verificationEmailSentMessage: The message that displays after a person submits their prayer and feedback. The default message is "Please check your email and follow the link to verify your submitted feedback or request for prayer."
  • mpp-prayer-feedback-form.submitButtonText: The label on the button the person clicks to submit their prayer and feedback request. The default is "Submit".
  • mpp-prayer-feedback-form.feedbackSubmitted: The message a person receives after verifying their prayer and feedback submission. The default is "Your feedback has been submitted. Thank you!"
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: