• Introduction
• Quick Setup
• Install the Mailjet Plugin
• Mailjet Plugin Settings
• Mailjet Widget Setup
• View the Subscription Widget
• Mailjet Contacts
• Mailjet Campaigns
• Mailjet Statistics
• Troubleshooting
• Conclusion

 

Introduction

WordPress is one of the most popular Content Management Systems (CMS) that exist on the internet and is used by over 20% of the websites currently live today. As a Mailjet user, we understand the importance of being able to use Mailjet natively within the different environments and applications that you already use.

This is why we have developed a native Mailjet WordPress Plugin that will allow you to benefit from:

• A customizable newsletter subscription widget
• Synchronize and manage contacts between your WordPress site and Mailjet
• Possible integration with WooCommerce and Contact Form 7
• Create, manage and send mass emails from directly within your WordPress Admin
• View the email engagement statistics (opens, clicks, bounces, blocks, etc.) in real time

We hope you find this plug-in helpful and look forward to any feedback you may have.

Happy Emailing,

Mailjet Integrations Team

 

Quick Setup

In this section, we will quickly go over what you need to do to configure the Mailjet plugin and the Mailjet Subscription Widget. Detailed explanations will be provided in the next sections of the guide. 

Configure the Mailjet Plugin

1. Once the plugin is installed and activated, click on its ‘Settings’ button, or select the Mailjet icon in the WordPress dashboard menu.
2. Enter your Mailjet API credentials (API Key and Secret Key) to link your Mailjet account.
3. Select the contact synchronization settings between WordPress and Mailjet to complete the initial configuration.
4. In the Mailjet Plugin Dashboard, click on ‘Settings’ to configure your WordPress emails to be sent through Mailjet under ‘Sending settings’. Feel free to edit the other configuration settings, like the integration connections with other WordPress plugins.

For more details, please see ‘Mailjet Plugin Settings‘ section. 

Configure the Mailjet Subscription Widget

1. In the WordPress dashboard, go to ‘Appearance’ → ‘Widgets’.
2. Find the ‘Mailjet Subscription Widget’ in the list of available widgets, then drag and drop it into the page section you want it to appear in.
3. Select a title for the subscription form, available languages, and a contact list, to which new subscribers to be added.
4. Customize your widget by clicking on ‘Advanced form customization’ after saving your initial settings.

For more details, please see the ‘Mailjet Widget Setup‘ section.

 

Install the Mailjet Plugin

Download within your WordPress Dashboard

From within your WordPress Dashboard, select ‘Plugins’ → ‘Add New’.

On the Add Plugins page, enter ‘Mailjet’ in the Keyword search field.

Mailjet for WordPress will be the 1^st result. Click the ‘Install Now’ button.

The plugin will be downloaded and installed. The last step is to click the ‘Activate’ link.

And you have successfully installed the Mailjet WordPress Plugin!

You are now ready to configure the plugin - please jump to the Mailjet Plugin Settings section.

Download from WordPress.org / GitHub

You can download the Mailjet Plugin directly from WordPress.org.

Go to the Mailjet Plugin Page, then click on ‘Download’.

Alternatively, you can download the latest release from our public repository on GitHub.

The next step is to install the Mailjet plugin onto your WordPress website. Log into your WordPress Dashboard and select ‘Plugins’ → ‘Add New’.

Click on ‘Upload Plugin’.

Click on the ‘Choose File’ button and select the Mailjet WordPress zip file from your computer. Then click on ‘Install Now’ to upload it to WordPress.

Once uploaded and installed, you will need to click the ‘Activate Plugin’ link.

And you have successfully installed the Mailjet WordPress Plugin!

You are now ready to configure the plugin settings!

 

Mailjet Plugin Settings

To configure the Mailjet plugin, click on ‘Setup account’ from the Installed Plugins page

or go to the newly appeared ‘Mailjet’ section in your WordPress dashboard.

You will be directed to a Welcome page, which gives you a short description of how the plugin works. You will be asked to enter your Mailjet API and Secret key here.

Let’s go through the initial setup of the plugin.

Connect Your Account

Enter your Mailjet API and Secret keys in the provided fields, then click on ‘Connect your account’. To view your API Key Information, click on the My Account > API Keys link.

Synchronize WordPress Users

The next step after submitting your API and Secret key is to set up the synchronization of WordPress users with a Mailjet contact list of your choice.

Under ‘Your Mailjet contact lists’ you will see a drop-down menu containing all lists in your Mailjet account. The number of contacts present in each list is displayed next to its name. This is the total number of contacts in the list, including ones who are unsubscribed and / or excluded from receiving campaign emails.

If you want to create a new list, click on the ‘Create a new list’ link. Choose a name for it, then click on ‘Save’.

Once configured, you will add your future WordPress subscribers to the list you have selected. If you want your existing subscribers transferred to the same list, simply tick the respective checkbox.

When you are finished, click on ‘Apply & continue’.

Plugin Settings

Once you have completed the initial setup of the plugin, we recommend you visit the Plugin Settings section to configure your sending and access options as well. Click on ‘Configure’ under ‘Configure WordPress email sending’.

Or, if you are in the Mailjet Dashboard, click on the ‘Settings’ button under ‘Update settings’.

Change Your Mailjet Account

If you want to switch to a different Mailjet account / API key, go to the ‘Connect your Mailjet account’ section. You will see information about the account, to which the plugin is currently linked. If you want to change it, click on ‘Connect to a different account’ and you will be redirected back to the ‘Connect your account’ initial setup page.

Select Sending Settings

In the ‘Sending settings’ you can enable emails to be sent via Mailjet. By using Mailjet’s SMTP relay to send your WordPress emails, you take advantage of Mailjet’s optimized email deliverability as well as gain the ability to track what happens to those emails (opens, clicks, bounces, blocks, etc.) in real-time on your Mailjet Stats page.

Please tick the checkbox now. This will allow your transactional emails to pass through using the SMTP credentials you have set up in Mailjet, improving their deliverability.

A new set of options will appear, asking you to select the ‘From’ name and email address for those emails, and to set the port that will be used to send your emails via the SMTP relay.

Enter the sender name you want to use. Then choose your preferred sender email address from the drop-down menu. 

Afterward, choose the port used to send your emails via the Mailjet SMTP relay. By default, we recommend using port 25. However some ISPs may block port 25, so try using port 587, or 465 (with SSL enabled) in case you have trouble with port 25. You can find this port information on your Mailjet SMTP Settings page.

Finally, click on ‘Save’ to submit the changes you have made.

Send a Test Email

Use the ‘Send a test’ option to send a test email to an email address of your choice.

The email will use the specified sending settings - the ‘From’ email / name and the selected port. The email content will include the same information, as well as the URL of your WordPress website.

Subscription Options

Sync Existing / New Users

The ‘Subscription Options’ section allows you to transfer your WordPress user details to a Mailjet contact list.

The workflow is the same as the one you followed during the initial plugin setup - tick the checkboxes next to the options you are interested in, then select a list of your choice from the drop-down menu.

Subscribe Comment Authors to Mailjet Lists

You can also enable a ‘Subscribe to our mailing list’ checkbox in the ‘Leave a reply’ form. This allows comment authors to subscribe to a contact list of your choice.

If a comment author ticks the checkbox, after submitting the reply they will receive an automatic email asking them to subscribe. They will need to click on a link within the email to complete the subscription process.

Click on ‘Save’ to submit your settings.

User Access

In the User access section you can set the user roles who have access to the Mailjet plugin. Of course, your role is set as the Administrator and cannot be changed. For more information on these user roles, please visit the WordPress Roles and Capabilities page.

Click on the ‘Save’ button to save your changes.

Integrations

Lastly, the Integrations section helps you connect the Mailjet plugin to other plugins you might have activated on your WordPress dashboard.

WooCommerce

WooCommerce records the customers that use your online store as WordPress users. That is why syncing your WordPress users with Mailjet will ensure that the contact information for registered WooCommerce customers is transferred to your selected Mailjet contact list.

In addition, you may want users who purchase items from your store to be subscribed to a different list - this is where the WooCommerce integration comes into play. It allows those customers to subscribe to a contact list of your choice upon checkout.

Users will see a ‘Subscribe to our newsletter’ checkbox on the checkout page - after ticking it and completing their checkout, they will receive a subscription confirmation email. Once they click on the confirmation link, they will be added to the list you have selected.

To activate this option, under ‘Integrations’ tick the checkbox next to ‘Enable WooCommerce integration’, then do the same for the ‘Display “Subscribe to our newsletter” checkbox’ option. Afterwards simply select a contact list of your choice and ‘Save’ your settings.

Contact Form 7

With the Contact Form 7 integration, you can add a subscription checkbox to your contact form and have subscribers added directly to a Mailjet contact list. If a user checks the subscription box and sends their message, they will receive an email with a subscription confirmation link. The user needs to click on this link to be added to your contact list.

To enable this option, go to ‘Integrations’ and check ‘Enable Contact Form 7 integration’. Then select a Mailjet contact list of your choice from the drop-down menu.

Then enter the tags for your Email and Name fields in the form. The tags should match the ones in the contact form.

Once you are ready, copy the shortcode displayed in the integration and click on ‘Save’.

You now need to paste the code into your form to enable the subscription checkbox. Go to ‘Contact’ → ‘Contact Forms’ and select your contact form.

Then simply paste the shortcode into the form. The checkbox’s position depends on where you have pasted the code - e.g. in the following form the checkbox will appear below all contact form fields, but above the “Send” button. To change the text next to the checkbox, edit the text within the quotation marks.

 

Mailjet Widget Setup

Add the Mailjet Widget

Now that the Mailjet plugin has been configured, the next step is to add the contact signup form to your website. With it you can easily capture new contacts directly from your site and synchronize them with your Mailjet contact lists.

Please note, you can add more than one signup form on your website, allowing you to collect different subscriber information in various contact lists.

This is done by first selecting ‘Appearance’ → ‘Widgets’ from the main WordPress dashboard menu.

Alternatively, go into your Mailjet Dashboard and click on ‘My Widgets’ under ‘Add a subscription form’.

On the Widgets page, you will see a list of all available widgets on the left-hand side including the ‘Mailjet Subscription Widget’. The sections on the right-hand side are where you tell your WordPress theme to put the specific widget by dragging it over from the left to the appropriate section in the right.

Another way to add a widget is to click on the widget name and a drop-down menu appears. Then select the desired position and click on the ‘Add Widget’ button.

For this example, the Mailjet Subscription Widget will be added to the Footer 2 area.

Once added to the Footer 2 section, the Mailjet Subscription Widget will expand to show the initial language setup options:

We will now take a closer look at the widget configuration settings. 

Widget Language Settings

First of all, you need to select the languages, in which this Mailjet subscription widget will be available. The available languages are English, French, German, Spanish and Italian.

Tick the checkbox next to the languages you want activated. For each one you will be asked to select the title of the subscription form (optional) and the contact list, to which the contacts will be subscribed (mandatory). Then click on ‘Save’.

Once you have saved your widget language settings, the form will become operational - contacts will be able to submit their emails and subscribe to your contact list. If you want to collect additional information from your users during the subscription process, or customize the form / confirmation email, see the next section for more information.

Advanced Customization Settings

Once the basic widget settings have been saved, the ‘Advanced form customization’ option will be activated.

Click on the link and a new pop-in window will appear. Here you can customize your subscription form by adding editing the available fields, content of your validation messages, confirmation email and “Thank You” page. 

Form Fields

In this tab you can customize the fields within the form - the email address field placeholder text and ‘Subscribe’ button text. You can also specify up to 5 additional contact property fields (first name, last name, etc.) that you want shown on your signup form.

Property Fields

Under ‘Properties’ you can select up to 5 contact property fields to be part of your subscription form.

First, choose a property from the drop-down menu. You can also create a new one by selecting the ’+ Create new’ option.

If you want to create a new property, you need to select its name and data type as well, then click on ‘Save’.

Once the property is selected, choose whether this will be a mandatory, optional or hidden field.

• Mandatory - Contacts are required to fill in the information for this field, otherwise they cannot subscribe. Those fields will be marked with an asterisk in the beginning of the placeholder text (e.g. ”* Enter Your First Name”)
• Optional - Contacts are not required to fill in the information for this field
• Hidden - These fields are not visible in the form. Instead, you select a value to this property and it is assigned to each subscribed contact. For example, this can help identify which form or language the contact subscribed from, if you are using the same contact list for multiple subscription forms / languages.

Finally, select the placeholder text (field label) for each language you activated for this form. In the case of hidden property fields, you need to select the property value for each language instead.

As mentioned, the maximum number of fields (visible and/or hidden) is five. The order you set them up in will determine the order, in which they appear on your website.

Email Address Field

You can customize the placeholder text for the email address field in the subscription form. If nothing is entered, the default placeholder text will be used instead - ‘your@email.com‘.

‘Subscribe’ Button Text

Choose the text you want to appear on the form submission button. If nothing is entered, the default text will be used instead - ‘Subscribe’.

Form Validation Messages

In this tab you can specify the text of the messages that could appear after contacts submit their information via the form.

• Form successfully submitted - Will be shown after a user clicks on the ‘Subscribe’ button and the subscription confirmation email is sent successfully.

  Default Text

• Error: Invalid data format - Will be displayed whenever a user enters data in an incorrect format in one of the form fields. For example, you ask users to submit their age in one of the fields, so they need to enter a number, but instead they enter text.

  Default Text

• Generic technical error message - If there was any kind of technical issue with the form submission, the user will see this error message.

  Default Text

Confirmation Email Content

After clicking on the ‘Subscribe’ button, contacts will be sent an automatic email containing a button, which they need to click on to confirm their subscription. The text of this email can be customized in the ‘Confirmation email content’ tab.

• Email Subject - The subject line of the confirmation email.

  Default Text

• Email content: title - The title, with which the email content will begin.

  Default Text

• Email content: main text - The main text of the email. Will be located above the subscription confirmation button. Use %s to enter your website URL in the text.

  Default Text

• Email content: confirmation button label - The text in the subscription confirmation button.

  Default Text

• Email content: text after the button - The text after the subscription confirmation button.

  Default Text

‘Thank You’ Page

In this tab you can select which web page will open once a contact clicks on their subscription confirmation button. You can use the default Mailjet Thank You page, or use one you have created in WordPress yourself.

 

View the Subscription Widget

Once you have configured the Mailjet widget, let’s see how it looks on a website.

For this example, the firstname field was added to the widget as an optional one, as explained in ‘Form Fields’ in the Widget Setup section of the guide.

The resulting subscription form can be seen in our website footer:

 

Mailjet Contacts

When someone subscribes to your site’s newsletters and/or marketing campaigns, their contact information is stored in a contact list. You can create and manage your contact lists from within WordPress or from your Mailjet Account.

How to Manage Your Mailjet Contact Lists

To send out your marketing campaigns with Mailjet, you need to use contact lists that contain the contact details of all the subscribers you want to reach. You can use these contact details to further connect with your customers with email personalization, tailoring each email sent within a campaign to make your users feel unique and important.

Here you will see a list of all the contact lists you currently have on your Mailjet account. If any contacts were automatically migrated, you will also see a newly created contact list. If you have no contact lists, the area will be empty.

In this section you will be able to create, edit, duplicate, archive and delete your contact lists. You can also create new contact properties, or add emails to your Campaign Exclusion List.

For detailed information please visit our dedicated guide on Managing your contact lists.

Contact Properties

To store details about your subscribers (name, age, city, …) in your Mailjet contact list, you need to define/create the different contact properties you wish to associate with your Mailjet contacts. Once defined, you can then import your contact list details and map them to the relevant contact properties on the Mailjet side.

The inclusion of additional details regarding your subscribers will help you with personalizing emails in Mailjet, or with segmentation of the contact list for marketing campaigns, for example.

For more information on how to manage the properties, please visit the Contact Properties section of our guide on Managing Contact Lists.

 

Mailjet Campaigns

From within WordPress, you can design beautiful marketing newsletters using Mailjet’s drag-and-drop HTML email builder, or pick from a gallery of templates. With one easy click, you can also turn your newsletter design into a template for future use. In addition, you have the option to import already created templates by pasting the HTML code in our HTML editor.

To access the Mailjet Campaigns section, click on ‘Campaigns’ within your Mailjet plug-in.

For detailed information on how to create and send your campaigns, please visit our dedicated guide.

 

Mailjet Statistics

To view the powerful real-time analytics of your campaigns and emails, click on the ‘Statistics’ link in WordPress.

Select the desired time range for the stats page.

By clicking on ‘Show me the reports’ you will be able to see information on each of the recipients of the campaign:

In addition to the Email List view (default), you can view the Open Analytics and the Click Analytics in a list view or via a map view.

By default, all emails statuses are displayed. You can filter the results to display only one email status via the ‘Status’ drop down menu.

To export the email lists section to a text file, click on the ‘Download all as CSV’ button.

To update a contact list based on the results, click on ‘Export to a list’. For example, if you wish to remove all the ‘bounced’ email addresses from a particular contact list, filter the results to show only ‘Bounce’, click on ‘Export to a list’ and follow the instructions.

 

Troubleshooting

In case you experience any issues with the WordPress functionalities, we encourage you to visit the WordPress Support page.

Of course, feel free to contact our Customer Support team, in case you come across any technical difficulties with the Mailjet product - our team of specialists will be more than happy to assist you! Please visit the Mailjet ‘Contact Us’ page for more information.

 

Conclusion

We hope you find this guide helpful. Feel free to let us know what you think of our WordPress plug-in, and especially what functionality we should do next by emailing plugins@mailjet.com.

Happy Emailing,

Mailjet Integrations Team