Mailing List

Mailing list subscription details are saved automatically when a customer creates a new account. In some cases, you may need to add a customer to a mailing list manually or edit an existing mailing list subscription record for a customer.

To add a customer to the mailing list, follow these steps:

1. Go to Email Marketing > Mailing List in the IRP Admin left navigation menu.
2. Click the Add To Mailing List button at the top of the page.
3. Enter the following details for the recipient. If you see an asterisk (*) beside a setting it means that the setting is required.

   Setting	Description
   Mailing List Details
   Mailing List ID	The unique IRP identifier for this mailing list subscription record. This is automatically generated when you add a mailing list subscription record.
   Name	The customer’s first name and surname.
   Email	The customer’s email address.
   Gender	The customer’s gender: Male, Female, Prefer Not To Say, Other. Note that the 'Other' option will be displayed on the MailingListEdit.aspx page (and the CustomerEdit.aspx page) only when the Enable Other Gender Input Application Setting (in the 'Customers' grouping) is enabled.
   Customer ID	The customer ID value.
   Last Updated	The date and time when this Mailing List entry was last updated.
   Voucher ID	(Shown if relevant and if customer has provided marketing consent.) The ID of the voucher. This is hyperlinked to the VoucherEdit.aspx page.
   Sent	(Shown if relevant and if customer has provided marketing consent.) If a voucher has been sent to the customer, this will show the date and time when the voucher was sent.
   Voucher Used	(Shown if relevant and if customer has provided marketing consent.) This indicates whether the voucher has been used. If the voucher has been used, this will show display 'Yes - Order ID ABCD', where ABCD is the OrderID of the previously-placed order. Otherwise this will display 'No'.
   Email Subscriptions
   Select which email profiles to subscribe the customer to. Note that an Email Profile must exist in your IRP to display here.
   Catalogue Subscriptions
   Select which catalogue profiles to subscribe the customer to. Note that a Catalogue Profile must exist in your IRP to display here.
   Address Details
   Address Line 1	The first line of the customer’s address.
   Address Line 2	The second line of the customer’s address.
   Town/City	The Town/City of the customer’s address.
   Region/County	The Region/County of the customer’s address.
   Country	The Country of the customer’s address.
   Postal/Zip Code	The Post Code/Zip Code of the customer’s address.

4. After you have been entered or edited the details, click the Insert Mailing List Entry button or the Update Mailing List Entry button to save them. If there are any errors, you will be notified at the top of the page. For example:
   
5. The entry will then appear on the MailingList.aspx page.

To add a batch of customers to the mailing list, follow these steps:

1. Go to Email Marketing > Mailing List in the IRP Admin left navigation menu.
2. Click the Batch Add To Mailing List button at the top of the page.
3. Enter the email addresses that you want to add in bulk to the mailing list. You need to enter each address on a new line:



4. Once complete, click the Validate Email Address List button to test the validity of the addresses. If there are any errors, they will be published at the top of the page. You must ensure that all addresses are valid before attempting to import them.



5. After successfully validating the addresses, you need to assign the addresses to specific email profiles. You can select specific profiles by checking the boxes beside each email profile. Note that the mailing list Batch Add functionality does not work for Catalogue Profiles.



6. Set the Language and Shipping Country for the addresses, then decide whether you want to re-subscribe existing emails to the selected profiles. This feature will update any existing customer’s mailing list settings/subscriptions with the email profiles you have selected.



7. Once you have entered the details, click the Import Email Addresses button to save them as part of the mailing list. You can now view and search for the newly-added customers on the MailingList.aspx page.

You can add an email subscription box to any standard or mobile page. By default the box appears as follows:

You add the widget by incorporating the following HTML on the page where you want it to appear:

An ID is required, and the class must be as shown above. You can specify two optional parameters for the email subscriptions:

• data-email-profile-id  This is the specific profile to which the customer will be subscribing when they provide their email address. If left blank, the customer will be subscribed to the default email profile(s). If there are no default email profiles then the customer will be subscribed to all active email profiles.
• data-subscribe-to-profile-only  This determines whether customers are subscribed only to the provided profile ID. If this parameter is not provided it will be considered false. When false the customer will also be subscribed to all default email profiles. If true they will be subscribed only to the provided email profile ID.

If these parameters are added then the HTML would appear as follows:

Customers with existing mailing list subscriptions will be redirected to their subscriptions page (or the login page) once they click the ‘Join Now’ button.

Customers with no previous subscriptions will be shown a message telling them if their subscription was successful or not.

The customer’s sign-up platform is recorded automatically against the mailing list entry. For example, if a customer subscribes from the mobile site or trade site, this is recorded in the database.

The control uses the following Small Translations:

• 851
• 852
• 854
• 898
• 1580
• 1813
• 2544

The control also uses the following CSS classes:

• .email-subscription-container
• .email-subscription
• .email-subscription-popup

You can add custom translations for the following email subscriptions widget values:

• Button text
• Button tooltip
• Default textbox text
• Error message
• Already subscribed message
• Success message

Note that for Interventions that use the Mailing List sign-up control, you can add each of these values and the corresponding translations on the InterventionEdit.aspx page.

In general, the following steps are required to provide custom content for each of the values listed above in any Mailing List signup widget:

1. Don't use the CSS class email-subscriptions-container on the custom subscriptions widget. Instead use a custom class or ID that can be used by the custom JavaScript, such as custom-email-subscriptions-widget.
2. Add a script with any of the following properties for the custom element:
   
   <div id="EmailSubscriptions1" class="custom-email-subscriptions-widget">
   <script type="text/javascript">
   $('.custom-email-subscriptions-widget').emailsubscriptions({ buttonText: 'My custom button text',
   buttonTooltip: 'My custom tooltip',
   textBoxDefaultText: 'My custom textbox text',
   errorMessage: 'Something went wrong',
   successMessage: 'You have been subscribed',
   alreadySubscribedMessage: 'You are already subscribed'
   });
   </script>
   </div>