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.
Note
If you do not already have a Mailjet account, now is the time to sign up for one. Simply click on the ‘Create an account’ link on the Mailjet Settings page or click here to go to Mailjet directly.
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.
Note
The sender email address must be a validated sender in your Mailjet account. To register new senders and check their status, please visit the ‘Sender domains & addresses’ section in your Mailjet account.
Afterwards 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.
Note
A send email can be sent successfully only once you have enabled sending through the Mailjet SMTP relay.
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.
Note
Along with the email, both the first name and last name of the customer will be saved in Mailjet as values of the firstname
and lastname
properties, respectively. If you don’t have properties with these names in your Mailjet account, they will be automatically created when a subscription request is received.
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.
Note
The Name field tag is optional, but if selected, the name entered by the user will also be recorded as the value of the name
property for that contact. You can enter also enter multiple field tags (e.g. [first-name] [last-name]
) - then the text entered in both fields will be combined and added as the value of the name
property.
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.