Building a Signup Form for Static Lists

If you want to allow your users to subscribe themselves to one of your static lists in Iterable, it's often useful to provide a form on your website.

For projects that use email as a unique identifier, Iterable provides a basic HTML form that adds a new user to your list whenever someone submits their information. You can customize and use this form on your website.

To get the form code, go to Audience > Lists, open the static list for which you want to create a signup form, and click Signup Form.

You can generate a form from an existing list, or create a new list and then generate a form.

These steps cover creating a new list and then creating a signup form.

1. To create a static list, go to Audience > Lists, click New List, and select Import Users. For more information, see Adding Users and Creating Lists.

2. Once you have a list for which you'd like to create a signup form, return to the Lists page.

3. Click the list's overflow menu (three dots), and select Signup Form.

4. Build your form. The embeddable code provides a basic signup form that displays a simple Enter Your Email text entry box and a Submit button without any additional styling, assets, or text. Customizing the form code is optional but recommended.

   To customize the signup form:

   • Change the value properties to display your desired CTAs. (For example, you could change the button CTA text from "Submit" to "Get on the list".)
   • Add a style property that includes the HTML/CSS needed to render the signup form in your brand's style.
   • Add additional input lines and values that render additional content as needed.
   • Add validation logic that prevents users from submitting an invalid email address and being redirected to an error page.

   NOTE

   Iterable doesn't support using a different domain for the signup form—the link always displays as links.iterable.com/lists/publicAddSubscriberForm.

The Preview tab shows an example of what the signup form could look like when the code is customized with additional text and styling and rendered on a website. It does not provide a live preview of the embeddable code.

You can submit email addresses in the form preview to verify that users will be subscribed to the associated list as expected when they complete the signup form. Email addresses submitted through the form preview are actually subscribed to the associated list. To avoid subscribing users to a list without their consent, it's recommended to only submit internal test email addresses you have access to (such as your own or a teammate's).