Articles on: How To Guides

Email Subscription Form

The email subscription form widget simplifies the task of collecting data from your email subscribers. Whether you're a solo developer kickstarting a new side project, or a major corporation with millions of users, the process of creating, implementing, and beginning to compile data on subscriber interest has never been more straightforward.

As for any Noticeable widget, you can create and edit options for your widgets from the Noticeable dashboard with no code. Once you include the widget code snipet onto your page, the email subscription form renders automatically and you are ready to collect user interest. However, the email subscription form widget has great flexibility in the sense that if you prefer to use your own HTML code to render the form on your pages, that's possible. That's what we explain hereafter.

Custom HTML form with action linking to Noticeable



By creating your own HTML form, no data is loaded and rendered from our servers. Instead, it is seamlessly integrated into your webpage. This integration allows for a seamless user experience and efficient performance. However, the drawback is that you have to set a specific form action URL and use field names that Noticeable supports.

Form action URL



The form POST action to use is https://forms.noticeable.io/esX where you need to replace X by your widget identifier.

Supported input fields



Here is the list of input field names that we support:

company-name
company-website
email
fist-name
full-name
hp (we recommend to use a hidden input field with this name and an empty value to fight against spam)
labels.Y (where Y is the identifier of a label that exists in your Noticeable project). It should be an input of type checkbox and has value on when checked.
last-name
user-id


By leveraging this approach, you can easily tailor the form to suit your specific requirements and design preferences.

Errors



Upon form submission, one of the following errors may happen. If you are using default options, the user who submitted the form is redirect to your Newspage with a clear error message. In the case you are using a custom error URL, you will receive the error code along with the error message either as query parameter or response header based on your preference. This allows you to display or customize any error message as you wish:

FORM_DISABLED
FORM_EMAIL_ADDRESS_INVALID_SYNTAX
FORM_EMAIL_ADDRESS_DISPOSABLE
FORM_EMAIL_ADDRESS_NO_MX_RECORD
FORM_EMAIL_SUBSCRIPTION_ALREADY_EXISTS
FORM_INTERNAL_SERVER_ERROR
FORM_INVALID_ARGUMENT
FORM_NOT_FOUND
FORM_ORIGIN_FORBIDDEN
FORM_RECAPTCHA_BAD_RESPONSE
FORM_RECAPTCHA_INVALID_INPUT_RESPONSE
FORM_RECAPTCHA_INVALID_INPUT_SECRET
FORM_RECAPTCHA_INTERNAL_ERROR
FORM_RECAPTCHA_MISSING_INPUT_RESPONSE
FORM_RECAPTCHA_MISSING_INPUT_SECRET
FORM_RECAPTCHA_TIMEOUT_OR_DUPLICATE
FORM_RECAPTCHA_UNEXPECTED_RESPONSE
FORM_RECAPTCHA_UNKNOWN_ERROR_CODE
FORM_TURNSTILE_BAD_RESPONSE
FORM_TURNSTILE_INTERNAL_ERROR
FORM_TURNSTILE_INVALID_INPUT_RESPONSE
FORM_TURNSTILE_INVALID_INPUT_SECRET
FORM_TURNSTILE_MISSING_INPUT_RESPONSE
FORM_TURNSTILE_MISSING_INPUT_SECRET
FORM_TURNSTILE_TIMEOUT_OR_DUPLICATE
FORM_TURNSTILE_UNKNOWN_ERROR_CODE
FORM_TURNSTILE_UNEXPECTED_RESPONSE

Updated on: 06/15/2023

Was this article helpful?

Share your feedback

Cancel

Thank you!