Skip to main content

Unsubscribe Form

Updated
 
Table of Contents
  1. 1. Overview
  2. 2. To create an Unsubscribe Form
      1. 2.1.1. Example
      2. 2.1.2. Testing the Form
  3. 3. Related

Overview

The Unsubscribe Form allows a contact to enter an email address and submit it to remove a subscription from a specific 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, then place the form code into your website.

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.
 

Related articles