Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Use this section to configure general properties, including the MailUp account URL, form title, etc.



Default Value


MailUp Console host

MailUp console URL

Image Added

Subscribe path

Subscription page name and path (do not modify this entry)



Plugin Title

Subscription form title shown where the widget is placed


"Sign up for our newsletter!"


Text shown under the title


“Enter your information and press Sign Up”

Submit Button

Text used for the submit button


"Sign Up"

Select preloaded CSS for widget

Select one of four predefined styles. [1]



Use placeholders instead of labelsIf checked, placeholders inside recipient fields will be used to display the names of the fields

Request confirmation by email

Asks new subscribers to confirm their subscription via email (recommended)



I am using WPML to translate this websiteCheck this option if your Wordpress site uses WPML or Polylang for multilanguage support.

[1] You can change the style of the sign up form as shown here.


Select which List in your MailUp account the new subscriber will be added to. MailUp accounts support multiple lists, but you can only add site visitors to one List (and optionally one Group within the List) using this widget.




Numeric list identifier. You can locate the ID in your MailUp console under "Settings > Codes Table".

List displayed name (NOT REQUIRED)

Not currently in use


Numeric Group identifier within the list. You can locate the IDs in your MailUp console under "Settings > Codes Table".

Personal Data Fields

The subscription form can pass up to eight separate pieces of information to MailUp. Either the email or the mobile phone number must be sent to MailUp for the user to be added to the system, so you must make at least one of those two fields required. The other six fields can be associated with any of the additional fields used in your MailUp console under "Manage > Personal Data Fields". Please note that one of this six additional fields is a date picker, so this particular field can only be used to send a date (in US format, mm/dd/yyyy).


Here you can edit the error messages that are shown when the submit button is pressed, if there is an issue.

Error type



“Thank you for subscribing to our newsletter. Check your email to confirm your subscription.”

Generic error

“There was an issue. Please try again.”

Invalid address

“The email address is not valid”

Already present

“It looks like you're already a subscriber!”

Terms and conditions

You can add up to two conditions the subscriber has to accept in order to subscribe the form. Enabling one or more conditions is optional.


In the example below two conditions are enabled, only the for the first one an additional text is provided. Please note that basic HTML can be included in the textarea field to link to an external document


Admin panelFrontend widget
Image Modified
Image Modified


Test connection

You can use the "Test" button to instantly verify the plugin settings you've configured, so that you are immediately aware if there is an IP addresses restriction configured in MailUp, or if an incorrect IP-based restriction set in MailUp is preventing the plugin to communicate with it.


Do I have to be a MailUp customer to use the plugin?

You must have activated a MailUp console (full account or a free trial) and then specify console the platform URL in plugin settings. On MailUp you must enable requests coming from the server that hosts your WordPress site (go to "Manage->Web service" and then select "frontend" in the dropdown menu to insert the IP address of your server. More than one address could be registered).

How can I configure my plugin?

Go to the admin panel, press "Settings" and then select "WP MailUp". Fill in or check all the fields using the help buttons if something is not clear.

How can I check if my plugin is working?

Just fill in the required fields and press the Test button. If the test is successful, try to subscribe to an address from the form. The specified contact will be added in to the MailUp distribution list specified in system settings.

Once the configuration is setupset up, can I make any changes/updates?

Yes, you can modify any of the sections ("General Data", "User Lists", "User Fields", "Errors" and "Terms and Conditions") and update the information.

How can I change the appearance of the plugin?

You can select between four (4) available styles (CSS), if no one matches with your need you can edit one of the existing CSS files (style1.css, ..., style4.css). Please note that editing is allowed only for users who have read/write access to those files.

Can subscribers sign-up


for my newsletter through a social account (e.g. Facebook)?

Yes, MailUp provides a simple integration with all the most used social networks. You could insert into your web site website a simple banner "Click here to subscribe to our newsletter using your Facebook account". This features feature is a standard one and you don't need to install any plugin, just activate a MailUp account.

Is it possible to translate this plugin?

Yes, edit each string within the settings panel. No need to edit any file. MailUp supports all the charsets. If you use WMPL or Polylang to manage multilanguage, check the corresponding option inside General Settings.

Why should I use this plugin and not other services, like



MailUp allows you to take control of subscribers (view, import, edit, delete, export) and of messages (define scheduling, content, and recipients).

Can I disable the plugin?

Yes. Click on the Plugins tab and click on "deactivate."

The plugin was configured correctly, but it still returns a "generic error" when I fill out the subscription form. Why?

The IP address of the Web site or blog is probably not registered in your MailUp console. See above under "Authorizing WordPress to communicate with MailUp". If you are still getting this generic error even after correctly registering the blog or Web site's IP address, please try disabling IP address validation in your MailUp console and try again. There are times when IP address validation does not work properly and it can cause this issue.

Can I insert the form within a single page?

Yes. You have to create the subscription form extrapolate the HTML code and paste it inside WordPress during the creation of an article or page (this depends on the theme used or the website set up).

Is it possible to create a shortcode?

Yes, it is. First, you have to create the subscription form in your MailUp platform and extract the HTML code from using the dedicated button. Then you can associate the HTML code to a shortcode. There are various free plugins downloadable from the WordPress that allows creating shortcodes using the HTML code of a subscription form.