Create a Subscription Form with our Form Editor

What's the difference between a subscription form and a contact form?

A subscription form is used to collect email addresses from users interested in receiving updates or marketing content. Through this form, subscribers will be added to the MailPoet list of your choice and you'll be able to send them newsletters.

A contact form is used for general communication between users and website owners/support teams. If you're looking at a contact form, we recommend using a 3rd-party plugin such as Contact Form 7 that integrates with MailPoet.

Quick links:



  • Adding a block
  • Creating a custom field
  • Editing a block
  • Removing a block
  • Removing a custom field
  • The MailPoet Form Editor uses the WordPress Block Editor (Gutenberg).



    • Select the list your subscribers will be added to when subscribing through this form;
    • Choose if they're going to see a message after subscribing or be redirected to a new page.

    If you don't want to pre-select these lists and would rather allow your subscribers to select which lists they want to join, add a block called List Selection. To do this, click on the " +" icon to open the popup with the options and search for List Selection.


    In the Styles tab, you can customize how your form will look like by changing the settings for:

    • Background Color
    • Background Image
    • Font Color
    • Font Size
    • Font Family
    • Input Padding
    • Border Size
    • Border Radius
    • Border Color
    • Alignment
    • Form Padding
    • Success Message Color
    • Error Message Color
    • Close Button Style

    Form Placement

    You can choose to display the form:

    When selecting the form option, you'll be able to see its settings where you can set it to be displayed on all pages and/or all pages and products, or only on specific pages and/or posts from a specific category/tag.

    For specific instructions on how to set up Pop-up and Slide-in forms, please check out this article.

    If you form doesn't show up, please go through the following steps.

    For the "Shortcode & other" option, you can choose to:

    • Add the form as a Gutenberg block or a shortcode to your pages and/or posts;
    • Add the form as a widget;
    • Get the PHP code to integrate it with your theme or the iFrame version if you want to use it on an external website.


    You can set a Subscriber tag or tags that you want to assign to any Subscribers who sign up via this form:

    Custom CSS

    You can style your form components with Cascading Style Sheets (CSS.) When saving your form, all the styles added in this panel will also be saved - there is no need to add these styles to your own theme's stylesheet. 

    MailPoet does not provide support for styling subscription forms. If you need help styling a form and would like to hire a developer, we recommend reaching out to one from Codeable (affiliate link).


    Adding a block

    Just click on the " +" icon to open the popup with the options to search for a block and manage default and custom fields.

    When expanding a panel ( i.e. Fields), you'll see all the block options for it.

    If you've already created a form using the new editor, you'll see also a panel for the Most used blocks.

    By clicking on an option, it will be automatically added to your form editor as a new block. 

    To see ALL the fields (including custom fields created), you should click on the "Browse all" button and a sidebar will be displayed with all the fields available to be added to your form:

    Creating a custom field

    To create a custom field, you should click on the "+" icon to add a block > Browse all > scroll down to the "Custom fields" section and click on the "Create custom field" option:

    Please note that all custom fields will be visible to your subscribers on the Manage Subscription page.

    If you're using a 3rd-party form plugin, make sure you don't have any custom field created with the MailPoet form editor set up as "mandatory" that is not included in your 3rd-party form. Otherwise, the subscription process and integration may not work as expected. In this case, you should be able to remove the custom field from the plugin by following these steps.

    Editing a block

    When selecting a block, you can edit its settings in the  Block tab on your form editor's sidebar.

    There you have the option to customize the field's Settings, Styles, and add custom CSS via the Advanced tab.

    You can move your blocks up and down by using the arrow buttons.

    Removing a block

    To remove it from the form, simply select the block and click on the 3 dots icon.

    Removing a custom field

    To completely delete a custom field from all forms, you have to first add it to form and then click on the " Delete this custom field" link in the Custom field settings.

    Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.