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

Custom Form Widget

Configuring Custom Form

Configure custom forms on your website using the Custom Form widget.

The Custom Form widget provides a powerful way to collect information from people and enable them to register for events or opportunities. This widget also supports conditional logic so you can hide or display follow-up questions based on a person's responses. See the Quick Start Guide to start using forms.

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>

There are two ways to display a custom form: standalone forms and website forms. The one you pick depends on your needs. With standalone forms, you can allow access to multiple standalone forms, which is great if you need to send an email with a link to the form. With website forms, you can add each form to your website with the help of your web team.

Use Standalone Forms

Use the Custom Form widget to display a standalone form on your website.

With standalone forms, you don't have to add each form as a page on your website. But you still need to set up a widget page so there is a place on your website to display your forms.
Set Up a Widget Page
  1. Create or identify the page where you want to host widgets on your website.
  2. Insert the following Custom Form widget code snippet into the body of this widget page.
    <mpp-custom-form></mpp-custom-form>
    Tip: To apply custom CSS to standalone forms, use the Widget Configurator widget to generate the code snippet.
    Once the page is in place, you can send your recipients the URL of the form you want them to complete.
Create a Form URL Link
  1. In the navigation menu, click Custom Forms > Forms.
  2. Open the form record you want to use.
  3. Copy the form's Form GUID.
  4. Add the Form GUID to the end of your church webpage's URL.
    https://{your church webpage}/{widget page}/?id=[Form_GUID]
  5. Copy that URL and insert it in an email with your instructions.
When the recipient clicks the link, the form you selected displays on the widget page of your website, where they can complete the form. (And don't worry, if a recipient tries to change the form GUID in the URL, they will not go to another form.)

Use Website Forms

Use the Custom Form widget to display forms on your website.

You can display each form on your website for people to complete.
  1. Create or identify the page on your website where you want to display the form.
  2. Use the Widget Configurator widget to insert the form GUID of the form you want to display.
  3. Insert the generated code snippet to add the Custom Form widget to your webpage.
People can find the form on your website and complete the form.

Widget Configuration

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

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

Platform Configuration

You can configure any form you create as a Custom Form widget, but the form must meet the following criteria to display and accept new form responses:
  • End Date: Today's date is before the end date, or the end date is blank.
  • Fields: Any fields selected for Depends On Values must be part of the same form. See Conditional Logic for more information.

This widget supports basic HTML text formatting (bold, italics, underline, unordered lists, ordered lists, and hyperlinks) for the form instructions. You can format the text in the Instructions field on the Form record. This field prevents unsupported HTML tags from displaying in the widget. While other formatting options may work, we do not guarantee or recommend using them.

Want to customize the success message that displays after someone submits a form? You can define that text in the Complete Message field on each form record. If you leave this field blank, the text of the mpp-custom-form.completeMessage application label displays instead.

Want to see your form before it goes live on your website? Replace your church's webpage where the forms widget is located and the form GUID in the link below to check it out!

https://{your forms widget webpage}/?id={Form_GUID}

Customization

Make sure your forms match your church's branding by customizing their look and feel.

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: Widgets use application labels to store and enter values for fields, buttons, headers, and instructions. 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-custom-form.completeMessage: The default is "Thank you! Your form has been submitted."
portal
MinistryPlatform
Widgets

Last updated: November 24, 2025

Related Articles: