Configuring One-Click Unsubscribe
Quick Start
Allow your Contacts to unsubscribe from a single publication or opt out of bulk email with the One-Click Unsubscribe Widget. See the Quick Start Guide for tips on getting the One-Click Unsubscribe Widget up and running.
If the shared script hasn't been added to your website, add it to the appropriate webpage, replacing "example-church.com" with the base URL of your church's website.
<script id="MPWidgets" src="https://example-church.com/widgets/dist/MPWidgets.js"></script>Create a webpage on your website that will display your One-Click Unsubscribe Widget, or identify the page on your website where it will be displayed.
Add the One-Click Unsubscribe Widget to your church website by adding the following snippet of code, along with required attributes, in the body of your chosen website page, modifying the required attributes discussed.
<mpp-unsubscribe></mpp-unsubscribe>Widget Configuration
- Target URL: The URL where the My Subscriptions Widget is placed on your website.Note: If you choose not to include the Target URL attribute, the My Subscriptions button will not display in the widget, so we recommend revising the Successful Bulk Email Opt-Out and Successful Unsubscribe Label application labels. The default text for both of these application labels references "My Subscriptions". See Customization for more information.
- Attribute: mysubscriptionswidgettargeturl
- Valid Value: relative or fully qualified URL
- Examples:
mysubscriptionswidgettargeturl="/mysubscriptions/"mysubscriptionswidgettargeturl="https://example-church.com/mysubscriptions/"
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-unsubscribe mysubscriptionswidgettargeturl="https://example-church.com/mysubscriptions/"></mpp-unsubscribe>Configure Your Widget
Fill out the Widget Configurator below, copy your generated widget code, and paste it into your website.
Link Configuration
The One-Click Unsubscribe Widget expects and relies on URL parameters. Navigating directly to this Widget without URL parameters will present no actions. Whichever page the One-Click Unsubscribe Widget is configured on should be specified in the URL. In our examples, we used "/unsubscribe" as the designated page. The links can be constructed and included in email footers or anywhere else your heart desires.
- The [Contact_GUID] token is a Contact Merge Field, so "Unsubscribe All" (bulk email opt-out) can be included in any Message or Template sent from any Platform Page.
- The [Publication_ID] token should only be included when Publication ID is a Data Field on a given Platform Page (for example, All Subscriptions or the Subscribers tab on Publications). Alternatively, it can be manually set.
Bulk Email Opt-Out
https://yourchurch.com/unsubscribe?cg=[Contact_GUID]
Publication Unsubscribe
https://yourchurch.com/unsubscribe?cg=[Contact_GUID]&pubid=[Publication_ID] While you can use these URLs anywhere, we strongly recommend creating snippets and including the appropriate snippet at the bottom of various templates used for publications or bulk emails. Want help setting up your snippet? A SPoC can contact Support.
Bulk Email Opt-Out Snippet
<a href="https://yourchurch.com/unsubscribe?cg=[Contact_GUID]">Bulk Email Opt-Out</a>
Publication Unsubscribe Snippet
<a href="https://yourchurch.com/unsubscribe?cg=[Contact_GUID]&pubid=[Publication_ID]">Unsubscribe</a>
Customization
All Widgets are customizable, so change the button color and update the labels to match your church. We suggest customizing your One-Click Unsubscribe Widget to match your Subscribe to Publication and My Subscriptions Widgets.
CustomCSS: Every Widget accepts the Custom CSS attribute. Include it before the opening Widget tag is closed to customize your Widgets.
Application Labels: You can update the button text and more. To make changes, go to and update the appropriate label(s). Note that you are responsible for all translations if the default is not used.
- mpp-unsubscribe.mySubscriptionsButtonText: My Subscriptions button text. Default is "My Subscriptions". Note: This button will not display if the optional attribute is not included.
- mpp-unsubscribe.successfulBulkEmailOptOut: Bulk opt-out confirmation. Default is "You have been removed from bulk email. Didn't intend to opt-out? Undo or update your subscriptions preferences below. Thank you!"
- mpp-unsubscribe.successfulUnsubscribeLabel: Unsubscribe confirmation. Default is "You have been unsubscribed. Didn't intend to unsubscribe? Undo or update your subscriptions preferences below. Thank you!"
- mpp-unsubscribe.unableToUnsubscribeError: Unable to unsubscribe error message. Default is "Unable to unsubscribe."