Configuring Newsletter Sign-Up – the definitive guide
Table of contents
After releasing ‘Qoate Newsletter Sign-Up’ a year ago, recoding it into ‘Newsletter Sign-up‘ and 25.000+ total downloads i’ve been getting quite a lot of questions on how to properly configure the plugin for the various newsletter services out there. I’m not surprised, configuring NSU isn’t quite easy for the non-tech savvy WP users. Time to make things easier by writing a comprehensive guide on how to configure Newsletter Sign-Up, with screenshots!
Downloading and installing Newsletter Sign-up
You can download and install Newsletter Sign-up just like you would with any other plugin. Head over to the WordPress plugin repository, search for ‘newsletter sign-up’ (which should lead you here) and hit the red download button.
Extract the files of ‘newsletter-sign-up.zip‘ into your wp-content/plugins folder and activate the plugin trough your WordPress admin panel. Not familiar with installing WordPress plugins? The WP Codex has a nice article on installing and managing plugins which should help you out.
Configuring Newsletter Sign-up
If you’ve sucessfully installed NSU your plugins page in the WP Admin will look somewhat like this.
![]()
Hit the settings button, which should take you to the Newsletter Sign-Up Configuration page. This page is divided into a few parts, the one that is the most important is also the hardest: General Settings / Newsletter Configuration. These settings are essential if you want to get NSU to work with your newsletter service.

What you fill in here depends on your newsletter service, if you select a mailinglist provider from the select box you’ll see the page change and some more setting fields will apear, or some fields will be autofilled for you to make things a bit easier. You could however just leave the select box at ‘– other / advanced’ and fill in the correct values yourself. If you’re using MailChimp or YMLP you have the option to use their API’s, which I recommend by the way. Let’s start with those two.
Using the MailChimp API
Select MailChimp from the newsletter provider selectbox and tick the checkbox that says ‘Use MailChimp API’. The plugin will now ask you for two values, your MailChimp API key and your MailChimp list ID. If you’re not sure on where to get those just hit the ?-links and you’ll be taken to a page with more information on where to get those.

Using the YMLP API
Select YMLP from the newsletter provider selectbox and tick the checkbox that says “Use YMLP API”. You will now need to provide three values, your YMLP API key, your YMLP username and your YMLP group ID. To get your API Key, just hit the ?-link.
Getting your YMLP group ID is a bit harder. Go to your YMLP dashboard and take a look at the “Your contacts” section. Hover the icons for each of your lists and you’ll notice that each URL ends with &groupid=X. The X is the number you’ll need here. If you only have one default list this number will most likely be 1.

A correctly configured YMLP API should make your NSU configuration screen look somewhat like this.

Other Newsletter providers / custom settings
If you’re using iContact, Aweber, PHPList, ConstantContact or some other newsletter provider, correctly configuring Newsletter Sign Up will be somewhat harder but definitely not impossible!
To understand what we’re trying to do it is important that you understand how NSU works. All newsletter services provide you with a sign-up form in HTML which you can embed on your website. NSU mimics this sign-up request by sending a request to the specified action URL and sending some values along with the request, like the email address of the person who is trying to sign-up.
So, let’s get into it. First, select ‘– other/ advanced’ or your newsletter provider from the select box. You’ll see a few input fields which (for a minimum) ask for a form action and an email identifier.
Head over to your mailinglist service and look for a sign-up form which you can embed. You can extract the form action and email identifier from this HTML snippet. Take a look at the following picture to get a better understanding of what values you need. I really hope this picture makes any sense…

Although the snippet in the above picture is overly simplified it should give you an idea of what to look for and which values you’ll need. Basically, all the input fields need to be covered so NSU can send those values along with the request to the form action whenever someone uses NSU to sign-up to your email list.
Testing if Newsletter Sign-Up is properly configured
Testing to see if you’ve properly configured Newsletter Sign-up is pretty straightforward. Using the checkbox at you’re comment form that asks people if they’re willing to sign-up to your newsletter? Just leave a test comment, tick the checkbox and see if it the email adress you used gets added to your email list.
One small note though. Make sure that you’re using an email address that is not already on your list since most newsletter services tend to ignore those requests. Also, be patient for at least a few minutes and check your spam folder!
Still not getting it? Try this.
- http://unwireme.com/boost-your-e-mail-newsletter-sign-up-conversion-rate-with-this-free-tip/
- Drop me a line trough the support forums for NSU, include your sign-up form and i’ll extract the values as soon as I find a spare minute!
78 Responses to “Configuring Newsletter Sign-Up – the definitive guide”
I updated this tonight and it’s working great! The only thing was that the First name field didn’t show up in my mailchimp subscribers. It looks like I was supposed to enter something after the mailchimp api and list id. Should it have been “First Name” or “mce-FNAME” or “FNAME”
Thanks!
i tried this plugin in my wordpress site but it did not works for me. i fillup this field corretly
Select your mailinglist provider: Mailchimp
Use MailChimp API? (recommended)
MailChimp API Key (?) XXXXXXXXXXXXXXX
MailChimp List ID (?) XXXXX
Where to show the sign-up checkbox? WordPress comment form
now everything are shown but whenever given the comment sign up functionality does not working.
Thank you for this my form is now working. Now if I could get it to look like your end of post sign-up form.
I’m trying to add the plug in, but is there a way to show the form without the widget? Something like this, for example:
<?php if (function_exists(‘akpc_most_popular’)) { ?>
<h2>Most Popular Posts</h2>
<ul>
<li><?php akpc_most_popular(); ?></li>
</ul>
<?php } ?>
Thanks!
Nice plugin.. Just wondering how to set an email attribute identifier when using mailchimp – I don’t seem to have that option so that it can recognise where to get the email address from when using a checkbox on another form.. so that part isn’t yet working for me..
thanks again
Is there any chance you will respond to my query Danny?
Thank-you.. Yes I have outputted this in the form of another plugin (Fast Secure Contact Form):
“
The other plugin is for a contact us form rather than comments, etc… the checkbox is displaying correctly but I am wondering how it can detect the id of the user’s email so upon submitting the form it can grab the email (and send it to mailchimp in my case).. hope this is clear
_thanks again
sorry this is the php that was escaped form the previous comment:
if(function_exists(‘ns_comment_checkbox’)) ns_comment_checkbox();
I’ll assume that this plugin doesn’t allow for the checkbox feature.
Hai i am using “Newsletter Sign-Up” plugin in my wordpress project..
In my mail-chimp form Email,Firstname,Zip,Birthday,Gender are reqiired fields…
Using Registration form of wordpress i signup in Newsletter…
My wordpress registration form contain all the above required fields…
But when a new user register only Email,Firstname correctly entered in Mail chimp database..
How can i add the other fields with correct data….
hi,
is there any way to register given mail address as a new user?
i mean, what i want is when somebody sign-up for mail listing i also want it to register as a new user to wordpress, is it possible??
thanks
well, i add the check box to registartion page i guess it will do it.
thanks for the plugin and quick reply.
Where do go to style this form?
I don’t know how to use the shortcode
I’m currently using the following code:
I just want everything to be transparent and borderless (including the button).
where do I change the color of the sign up button?
I’m using PHPList and would like to use this with WP, but wonder if NSU can handle:
– multiple newsletters (user can select one or several)
– multiple attributes for the user, e.g. first name, last name, city, …
– menu selectable attributes for the user,e.g. the country of the user, the state, …
I know PHP but would like to avoid hacking NSU unless needed.
Hello,
Currently I am using the plugin in localhost, but with most of the configuration I am not getting the name and the email on my mailchimp list as subscriber. I am using widget of the plugin.
Actually now I’ve changed my setup and am not using WP at the top, so don’t need NSU now.
Thanks, setting up now. Wish me luck.
Hi,
Thanks a lot . this plugin has been a great help in solving my problem.
Keep up the good work!
:)
Hi Danny,
Thanks for the awesome plugin. I am also planning on making use of the WYSIWYG Widgets plugin which is also awesome!
In the Newsletter Sign-Up Settings page it’s stated that you can easily edit your widget’s sign-up form text by installing the WYSIWYG Widgets plugin alongside this plugin. I was hoping you could clarify how this is possible.
I haven’t found any way to easily edit my widget’s sign-up form text with both plugins installed.
Hi,
I just added this plugin. It works great except the First and Last Name values are not being stored in MailChimp. I’m not sure why this is happening considering my test comments have the Name field filled in. Is it something to do with the Name Identifier? Please advise.
Is it possible to add an initial value to the email entry area
Is there a short code that’s used to add email sign-up form to post?
Thanks.
Hi Danny,
I am using the plugin as a widget for users to sign up for the newsletter, but whenever i enter an email it doesnt get populated to my list.
I am using mailchimp, I entered the API key and list ID as directed, but when I watch the POST in the net panel of firebug,the post looks correct but the response is just the html of my site. It also seems like it is getting posted to mailchimp because under the API calls tab I can see new requests. Still it does not populate!
I would appreciate any help or any suggestions, perhaps there is something i need to change in mailchimp, though from reading your other responses I am already using only one input field for email on my list form.
Hi danny,
First off thanks for the plugin,
I really like the functionality of it but I’m having little problem.
The plugin works fine to a point, it adds subscribers to mailchimp but doesn’t work with the wysiwyg, the wysiwyg works on it’s own, the edit window pops up as soon as I click a field but when I click into the plugin nothing happens.
Also there’s a little quirk in the wp-admin panel the wp-admin text & links that’s at the bottom of every screen:
(Thank you for creating with WordPress. • Documentation • Freedoms • Feedback • Credits)
Is half way up the screen? I’ve added a pic so you can see.
http://img11.imageshack.us/img11/7757/nsuissue.jpg
I’ve tried reinstalling and tried on another theme but still get the same issues? is it maybe a host issue, i’ve looked around and I can’t see anyone else with this problem.
I’d really like to get this sorted as I really want to use this it’s exactly what I’m looking for.
Thanks for all your work danny,
cheers.
Hi Danny, brilliant thanks, I have bought you a beer to show my appreciation. Keep up the good work.
Hi,
I love the idea of the plugin, especially for the comment check-box. I have figured out the “form” and “email” fields for Feedburner. The button shows up, so does the comment when I hit submit, but the sign-up form and/or any confirmation emails never show up. It looks like it doesn’t trigger the sign up, what could be the problem.
Thank you!
Barb
Hey Danny -
I have seen plugin similar to this that charges $$$ glad I found yours :)
Thanks for the hard work.
Shawn
Thanks for the great plugin!
I’m using the contact form 7 plugin – is there a way to enable the “sign up for my newsletter” checkbox in that form, just like in the comments?
Thanks,
Nick
Is there any way to integrate this to a contact form/enquiry form? I am OK with using any other plugin as well. I also have a Wufoo account that lets you create and publish forms on your website. Thanks for your help! Great plugin.
Hi Danny,
I have installed your plugin fine and it looks great – I would just like it to appear at the top of my sidebar above the loop – would you be able to let me know how to do this – I am new to wordpress and figuring things out gradually!
Many thanks for your help,
Jo
OK thanks Danny – yes it must be hardcoded – I’ll figure it out! Cheers Jo
Hi Danny,
Great plugin – works exactly as I hope it would. Unfortunately, I am having trouble styling it. I note that there are various CSS files within your plugin, but altering the stylesheets seems to make no difference. Can you please advise which classes or IDs I should be targeting in order to change the style of the comments checkbox?
Thank you!
Tom
Danny, is it possible to publish this form in multiple languages as (like in the menu) does not work..
thank you in advance! Great plugin!
I like that this plug is lightweight, but when someone submits the form, it takes them to my contact page and is asking for a recatpcha. ???
And, I never saw where you answered questions about customizing css for the actual form. Where is the css stored? Is it auto-inserted into the theme’s css?
Thanks,
//rt
Hi! Yes using wpml! it is great, would be great if you can look into this! Many thanks!
Great plugin, thanks!
I’m getting the sign-up form on my sidebar, but checkbox isn’t appearing in my contact form?
Anyone had this issue?
sorry, just saw comments above. please disregard previous comment.
Hey Danny, thanks for looking at my question above. My problem was actually that I had a sign up form in the footer of the Contact Page. Instead of worrying about it, I just took the form off of that one page.
Here’s some other things I couldn’t figure out: Is there a way to show a banner/img in the header, instead of the h4? And, is there a way to control the width of the label inputs? I see an option on mailchimp, but it doesn’t translate on the page, even with custom css turned off. I just don’t want to start changing code on the actual widget without asking.
I am not tech enough to understand what you said and implement:
“Extract the files of ‘newsletter-sign-up.zip‘ into your wp-content/plugins folder and activate the plugin trough your WordPress admin panel.”
Unsure about extracting file into wp-content. I signed up for icontact accoun but have not yet got that going either.
Hi Danny,
Love the Plugin, thanks a lot!
But… can I work with it using WordPress 3.3?
Thanks.
Pieter
Hi Danny,
I’m using your WP extension for a couple days. And I think that I’ve got a little problem. (I’m using WP 3.3 since Monday)
I put ‘nsu_signup_form()’ in a part off my templates.
It seems to work but my mailingList on Mailchimp isn’t updated at all.
I’m using Mailchimp API, Settings, Checkbox and Form settings seems to be OK. I don’t do anything in the ‘Config Extractor’.
Can I hope for a little help ;)
Thanx for your work!
(excuse my english – I’m a stupid french ^^)
Hi Danny,
Can you help me with YMLP?
Can’t get the form right.
Het gaat dan om de checkbox settings en de form settings.
De rest is allemaal goed gelukt: de API code etc van YMLP.
Ik hoor het graag.
Pieter
Hi Danny,
Great plug-in. Just wondering if it works OK if you use it on two different sidebars – I am using the ‘custom sidebar’ widget and want to have your newsletter plug-in with another plugin on one sidebar and just your newsletter sign-up on another sidebar.
I am new to wordpress so wanted to check before I tried incase I got myself in a pickle! I am probably going to be using mailchimp.
Many thanks for your help.
Jo
How can I make this work with icontact. I can’t figure out what the form action is.
Hey Danny, thanks for your work. However, I can’t make it run with my PHPList-Installation although I have tried a while now and read all posts in the WordPress-Forum. The Problem: The form always takes me to the original sign-up page and re-enters the data there, but doesn’t actually submit the page.
Did you ever see an installation with PHPList which actually works? Most forum-posts I’ve seen report the same problem I have.
Here is my current form: http://vdch.de.dd14120.kasserver.com/ (Bottom of the page).
Thanx for your help!
Phil
i have successfully installed the plugin and now applied it as a widget on my wordpress project.
the problem is i have fields underneath the subscribe button on my side bar….when i supply values for those fields and click on signup in works fine….but when i try to enter an email value to the subcribe field and click on subscribe it displays a message that
“The feed does not have subscriptions by email enabled”
how do i solve this problem please
Any plans for support for Campaign Monitor?
Hi Danny,
Thanks a ton for the plugin. It is awesome but I’m having trouble using the Y
Thanks for the really cool plugin. I really appreciate your development.
I am having a problem using the plugin with the YMLP api in the sidebar widget.
It looks like its working when I plug in an new email address and submit, but then I never receive a confirmation email to that email address.
I am sure that all of my configuration info is correct so I’m not sure what more to check.
Any help on this would be great! Thanks.
I have followed the guide, but can’t get it to work with mailchimp, namely the comment box option. I’m wondering if it has something to do with the fact that I didn’t specify anything in the Name/Value fields. I didn’t quite understand how to do that or if I needed to.
Thanks.
Disregard. I’m a moron. Thanks for the awesome plugin.
Hello,
I use YLMP and I have a problem to add the fields ‘name’ in my list
I put ‘author’ is the name of the fields of my wordpress comments but the name never appears in the fields of my list
Nice job the plugin.
Best Regards
Patrick
Great Job on this! We are starting to use this plugin instead of other Mailchimp Subscription widgets that are out there.
I noticed that you have added some functionality to integrate groups through Mailchimp. It seems like this only goes so far as to make the form automatically sign each person up for all of the groups that are listed in the comma delimited list in the plugin admin for mailchimp api.
I made a few alterations to the code so that the groups added in the admin are then listed on the form with checkboxes. This allows the registree to choose his/her groups. Following is my code and notes in case it might help you in your next version, though your PHP will almost certainly be more elegant:
——————————————-
Newsletter signup change notes
Jim Camomile – 12/03/12
Goal of changing the code:
Add the groups checkboxes to the form and make the form register subscriber only to those groups
Changes
1. change form code in frontend/NewsletterSignUp.php lines 563ff
– IF groups have been added in admin, they will appear in checkboxes
——————————————
// Added by Jim Camomile for Adding Groups
if(isset($opts["mailinglist"]['mc_use_groupings']) && $opts["mailinglist"]['mc_use_groupings'] == 1 && !empty($opts["mailinglist"]
['mc_groupings_name'])) {
$output .= ”;
$output .= ”.$opts["mailinglist"]['mc_groupings_name'].”;
$groupsarray = explode(‘,’,$opts["mailinglist"]['mc_groupings_groups']);
$thegroups = $groupsarray;
$thecount = 0;
foreach($thegroups as $thegroup){
$thecount++;
$output .= ”;
$output .= ”;
$output .= ”.$thegroup.”;
$output .= ”;
}
$output .= ”;
} // end if there are mailing list groups – by Jim Camomile
// End Adding Groups
——————————————
2. added code to the form processor frontend/NewsletterSignUp.php lines 243ff
- gets the values for the groups which were submitted in the form. If group values exist from the form post, these are used instead of the default
sting in $opts['mc_groupings_groups'].
——————————————-
// Jim Camomile added the following to change groups that are added for registration
$getgroups = $_POST;
$mygroups = array();
foreach ($getgroups as $key => $value){
$gotgroup = substr($key,0,5);
if ($gotgroup==’group’){
$mygroups[] = $value;
}
}
if ($mygroups){
$opts['mc_groupings_groups'] = implode(‘,’,$mygroups);
}
// print_r($opts['mc_groupings_groups']);
// exit;
// end added by Jim
——————————————-
Hi Danny
I really like the sound of your plugin but I’m looking to use “contact form 7″ plugin as our main contact form. Is there a way to enable the “sign up for my newsletter” checkbox in forms created by “contact form 7″ ? I see in your comments September 5, 2011 that it was on your to-do-list so just wondering if this is now possible?
Thanks very much
I’ve installed your plugin and set it up to work with our MailChimp account, but the check box is not showing. Is there an integration problem with Jetpack comments? Thanks in advance your your response.
Thanks for the referral Danny! Love the plugin, keep up the good work :)