Snippets

An overview about Snippets in MinistryPlatform.

Snippets are pre-written HTML text that provide additional information or links to relevant resources. This allows you to reuse certain text in many messages without having to recreate that text over and over again, which eliminates the possibility of typos! For example, you may have a Snippet for your church's website link that you include in all messages to prospects.
There are several predefined Snippets in your system. Customize these or add your own Snippets! See Create and Edit Snippets.
You can insert Snippets into messages using the New Message Tool.
Once sent, the Snippet may include information specific to each recipient. So, do not copy Snippets from sent emails.
You can use Snippets in notification messages as long as the notification supports the [Domain_GUID] and [Contact_GUID] merge fields. See articles specific to each Notification for more details.

Predefined Snippets

Some predefined Snippets are included with your MinistryPlatform instance. You can find these under Communications > Communication Snippets.

If your instance does not have a Snippet you need, contact Support to get them added to your system.
Before you can use them, you must edit each Snippet to use your domain address.
Widgets do not support auto-login Snippets but may have an equivalent available.

*Event Sign Up: Requires an Event ID each time you use it. Add the Event ID using the source view. For more details and steps, see Insert an Event-Specific Snippet.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Event Details and Registration widget for event sign-up.
*Group Sign Up: Requires a Group ID each time you use it. Add the Group ID using the source view.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Group Details widget for group sign-up.
*Opportunity Sign Up: Requires an Opportunity ID each time you use it. Add the Opportunity ID using the source view.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Opportunity Details widget for opportunity sign-up.
Cancel Recurring Gifts: Logs in and displays Giving History page. This is only available on the Donors page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Giving Widgets.
CareLife Login: Takes the user to the Care Life Dashboard.
GroupLife Login: Requires a Group ID each time you use it. Add the Group ID using the source view.
Church Directory: Logs in and displays the Church Directory page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Online Directory.
Event Calendar: Logs in and displays the Event Calendar.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Event Finder.
Event Registrations: Logs in and displays the Event Calendar with the Registrations filter.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Event Details and Registration widget.
Give Online: Logs in and displays the Online Giving page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Make a Pledge widget.
Global Unsubscribe link: Uses SendGrid's Group Unsubscribe Substitution tag for global unsubscription. Once clicked, the user will no longer receive any messages that you send from MinistryPlatform.
Tip: In limit unsubscriptions to a certain group of emails instead, you'll want to use publications. That way, you can use the Publication Unsubscribe link snippet so people don't miss out on your messages!
Group Finder / Group Finder (by survey): Logs in and displays the Group Finder page or the Group Finder (Survey) page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Group Finder.
My Contribution Statement: Logs in and displays Contribution Statement page. This is only available on the Donors page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the My Contribution Statements widget.
My Giving History: Logs in and displays Giving History page. This is only available on the Donors page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the My Giving widget.
My Groups: Logs in and displays the My Groups page.
This is an auto-login Snippet for the Portal. If you use Life Apps, check out Group Life.
My Subscriptions: Logs in and displays Subscriptions page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the My Subscriptions widget.
My Survey: Logs in and displays My Survey page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the About Me widget.
My User Account: Logs in and displays My User Account.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Login widget.
Opportunity Finder / Opportunity Finder (by survey): Logs in and displays the Opportunity Finder page or the Opportunity Finder (Survey) page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the Opportunity Finder.
Publication Unsubscribe link: This is only available on the Publications page. Uses SendGrid's Group Unsubscribe Substitution tag for group unsubscription. Once clicked, the user will no longer receive messages that you send from a certain publication in MinistryPlatform. You can edit the link text in this snippet. For more information, see Use Publications for Unsubscriptions.
Support A Mission Trip: Logs in and displays the Mission Trip Giving page.
This is an auto-login Snippet for the Portal. If you use Widgets, check out the My Mission Trips widget.

Create and Edit Snippets

To create and edit Snippets, go to Communications > Communication Snippets.

To include links in your Snippets, go to the appropriate Page in the Platform and copy the URL.

Note: When you view groups, the URL includes the Group ID. So, you want to create individual Snippets for each Group link.

To restrict which Pages have the Snippet, add the Page to the Pertains To field of the Communication Snippets record. If you want to make the Snippet available on any Page, leave this field blank.

Example of the Snippet record for My Contribution Statement

Insert Snippets into a Message

Important: Snippets are a unique link for each recipient. To avoid sharing someone's personal link with all recipients, do not copy a personalized Snippet from a previous message. Always insert a Snippet into your message as described in this topic.

Open the New Message Tool.
Place your cursor in your Message text where you want to add the Snippet.
Click Insert > Snippets, and select the Snippet you want.
Send your message as usual.

Insert an Event-Specific Snippet

You can send a message that includes the Event Sign Up Snippet so people can quickly get to the Event Registration page on your Portal.

This is an auto-login Snippet for the Portal. Widgets do not support auto-login links, but you can use the Event Details and Registration.
You'll need the Event ID number. To find this, open the Event record and look at the title.

Open the New Message Tool.
Prepare your message.
Click Insert > Snippets, and select *Event Sign Up.
Click the View HTML Source button.
Look for the long string of characters ending with "id=0".
Change the "0" to the ID value from the Event record.
Click the View HTML Source button again.
Make any other edits to your message, and send it as usual.

When a recipient clicks this Snippet in the message, they are logged in to their Portal account and directed to the Event Registration page.

What would you like to know more about?

Snippets

Predefined Snippets

Create and Edit Snippets

Insert Snippets into a Message

Insert an Event-Specific Snippet

Footer Section

Additional Resources

Company

We’re here for you.