With the Custom Form widget, people can complete a custom form on your website.

• The widget can display one form of your choice, or you can embed the widget in a page to display multiple standalone forms that people access through a link.
• Fields are sorted by the field order defined on the form field records.
• Additional fields may display depending on conditional logic.
• If you set up a form with Force Login set to Yes, people must log in before they can complete the form. People that don't log in only see the form title and a login button. They will not see any fields until they log in.
• You can customize the message that displays after someone submits a form. Enter your message in the Complete Message field on each form record. If left blank, the text of the mpp-custom-form.completeMessage application label displays instead.
• You can see a preview of your form! Select one of the following URLs, and replace the items in brackets with the necessary information:
  • If the widget is already in place on your church website, use https://{your church webpage}/{widget page}/?id=[form GUID]
  • If the widget is not yet on your church website, use https://{your MP base URL}/widgets/get_form.aspx?ID=[form GUID]

Sections

Instructions

The form's Instructions field.

Contact Fields

Fields for First Name, Last Name, Email Address, and Mobile Phone display. If Get Contact Info is set to Yes on the form, these fields are required. The widget uses this information to match the respondent to an existing contact or the default contact.

Address Fields

Address fields display and are required if Get Address Info is set to Yes on the form. For those that log in, the widget autofills their fields if they have an address listed. If they overwrite the autofilled values, it updates the form response, contact record, and/or household address.

Form Fields

All form fields associated with this form will display unless they are hidden or dependent on another field.

Complete Form As

Using this drop-down list, the person logged in can select their personal record or the record of a family member. The information of the selected record autofills for contact fields and address fields, as applicable.

Actions

Login

If the form has Force Login set to Yes, a login button displays under the form title with a message prompting the person to log in. All other fields and buttons are hidden until they log in.

Use the contact/address info provided to update my record on file

If a person is logged in, they can update their MinistryPlatform record with the information they submit on the form under contact fields and address fields. By default, this option is blank, so the person must select it if they want to update their record.

Upload a File

People can upload one file, such as an image or scanned document, with their form. Accepted file types include .pdf, .png, .gif, .jpg, .jpeg, .jfif, .pjpeg, .pjp, and .avif. The total maximum size allowed is 20 MB for an attached file.

Submit Form

This creates a form response record and form answer records for each form field. If the person is logged in or matched, the form responses are assigned to the individual; otherwise, responses will be assigned to the default contact.

Setup

Want to set up the Custom Form widget? See Configuring Custom Form for details to get started!