Skip to main content

Global Opt Out Form

Updated
Overview

Modify a regular Unsubscribe Form to generate a Global Opt-Out when a contact chooses to Unsubscribe from your list.

To create an Unsubscribe Form
  1. Go to CONTACTS > SUBSCRIPTION FORM WIZARD.
  2. Select a List.
  3. From Generate select 'Unsubscribe Form'.
  4. Enter a Goto URL for the landing page.  If no landing page is defined, the form will use the Landing Page defined in your List properties.  If no Landing Page is defined, the contact will see a default platform welcome page.
  5. Enter an Error Landing Page. If no landing page is defined, the form will use the Landing Page defined in your List properties.  If no Landing Page is defined, the contact will see a default platform error page.
  6. Click NEXT.
  7. Select the form code and paste into a text editor to customize the form further.
  8. Add the following line of code after the last hidden input and place the form code into your website:

<input type="hidden" id="global" name="global" value="1">

Example

The following is an example of how the form code will appear, where [siteURL] is the URL of your domain, [slid] is the special list id, [gotoURL] is the success Landing Page, and [errorURL] is the Error Landing Page.

<form action="http://[siteURL]/bin/listctrl" method="POST" name="unsubscribe_form">
<input type="hidden" id="slid" name="slid" value="[slid]" /> 
<input type="hidden" id="cmd" name="cmd" value="unsubscribe" />
<input type="hidden" id="goto" name="goto" value="[gotoURL]" />
<input type="hidden" id="errors_to" name="errors_to" value="[errorURL]" />
Email: <input type="text" id="email" name="email" size="25" />
<input type="submit" value="Unsubscribe" />
</form>

Testing the Form

Once you have created a form, test it to ensure it is functioning as expected.  To test your unsubscribe form:

  1. Login to your realm.
  2. Go to CONTACTS > SEARCH FOR CONTACT.
  3. Click ADD.
  4. Enter an Email address to create a test contact.  Click the Subscription tab and select the list to test against, then click SAVE.
  5. Save the form as an .html file. 
  6. Open the .html file in your browser.
  7. Fill the form fields with the test Email address, then submit the form.
  8. Login to your realm.
  9. Go to CONTACTS > SEARCH FOR CONTACT.
  10. Enter the Email address submitted above, then click SEARCH. 
  11. Double click the contact record to view the details.
  12. Verify the subscription was removed in the Subscription tab and the Global Opt Out is selected.
 

Related articles