Your site has one built-in sign-up form, so you do not need to paste any embed code from your email provider. It asks for a first name, an email address and a tick-box to agree to your privacy policy, then saves the person to your email list. Because there is no provider script to load, your pages stay fast.
You choose where those sign-ups are saved: your email provider (MailerLite, Kit, Brevo, Mailchimp or AWeber) or your site's own Subscribers list, where you can send newsletters yourself. This guide explains that choice, where the form appears, how to connect a provider and how to set up a waitlist.
Step 1: Choose where sign-ups go
Go to Site Settings, then Email Settings, then Email Marketing Integration and find Where do email sign-ups go? It is one setting for the whole site. It covers the tick-box at checkout and registration, the buyers opt-in on the purchases page, waitlists, Newsletter and Waitlist blocks, the forms on blog posts, LinkHub pages, free tools and Topic Cluster pages, and the "keep me updated" tick-box on a questionnaire.
- My email provider: sign-ups go to your provider and you send your emails from there. Choose this if you already use a provider or want its automations and templates. Your provider handles unsubscribes.
- This site's own Subscribers list: sign-ups are saved in your admin under Email Subscribers, then Subscribers, and you send from Email Subscribers, then Newsletters. You do not need a provider account.
Pick one. There is no "both", because two lists means two places to update and two places to unsubscribe people. If you have not connected a provider, sign-ups are kept on your site automatically so nobody is lost while you decide. Changing the setting later does not move anyone: people already on a list stay where they are, and new sign-ups follow the setting. Anyone you market to must be on a list with an unsubscribe link, and both options give you one.
Before you start (self-hosted sites)
Your email provider API key is saved encrypted, using the ENCRYPTION_KEY in your .env file. If the key is missing, saving the API key shows a red error and nothing is saved. Generate the key once and keep a copy somewhere safe. The full explanation is in The Encryption Key: Why It's Critical and How to Avoid Losing It. If you chose your site's own Subscribers list, you do not need a provider key, but the site's normal email (SMTP) settings must work, because that is how newsletters are sent.
Step 2: Connect your email provider (only if you chose your provider)
In the same place, choose your provider and enter two things:
- API key: generated in your provider's account.
- List ID: the number that identifies the list or group new people join.
Djangify works with MailerLite, Kit (ConvertKit), Brevo, Mailchimp and AWeber. The list ID is the number people most often get wrong, because each provider calls it something different:
- MailerLite: the Group ID. Open Subscribers, then Groups, then open the group and copy the long number from the web address. Do not use the number from the Forms page: that is a form ID and MailerLite will refuse it with "The selected groups.0 is invalid".
- Kit (ConvertKit): the Form ID.
- Brevo: the List ID, a plain number shown next to the list name.
- Mailchimp: the Audience ID, found under Audience settings.
- AWeber: the account ID and list ID separated by a slash, for example 12345/678910.
Providers move their menus around, so check their current help pages for where to find the API key and the ID. Your API key is stored encrypted and is never shown again after you save it.
Where the form appears
The same form is used in several places. Each place can have its own title, wording, list and tag (the list and tag apply when sign-ups go to a provider; on your site's own list every sign-up joins the one Subscribers list and the place is recorded as its source).
- Under a Coming Soon product: a waitlist box. Set the wording in Site Settings, Email Settings, Waitlist sign-up.
- Waitlist block: a waitlist on any page that is not tied to a product. Add a Waitlist block through the page's content container.
- Newsletter block: add a Newsletter block to a page and leave the embed code box empty to get the built-in form.
- The end of every blog post: Site Settings, Email Settings, Newsletter sign-up on blog posts.
- LinkHub pages: Site Settings, Email Settings, Newsletter sign-up on LinkHub pages.
- Under a free tool: Site Settings, Email Settings, Newsletter sign-up on free tools. The person is also emailed their results. The list and tag are set on each tool.
- Under a Topic Cluster download button: appears automatically.
- Hero banner: when the banner's newsletter block has no embed code, the built-in first name and email form is shown on the banner.
- Questionnaire block: a short survey on any page. The answers are always saved on your site. A separate tick-box, "Keep me updated by email", adds the person to your list, following the setting in Step 1. Giving an email address without ticking that box does not add them to any list.
If you would rather use your provider's own form, for example because you want extra fields, paste its embed code into the Newsletter block and that block uses it instead.
Lists and tags (provider only)
- List ID per place (optional): leave it blank and people join your default list. Enter a different ID and that place keeps its own list.
- Tag per place (optional): use it to see where people came from, for example blogsu or toolssu. A tag does not replace the list ID. They work together.
- MailerLite has no tags, so a tag becomes a group. The group is created automatically the first time the tag is used, and the person is added to it in addition to your main list. In Kit, Brevo and Mailchimp it is a normal tag.
Privacy policy link and tick-box
Under Site Settings, Email Settings, Built-in sign-up form, set the link to your privacy policy. It defaults to /policies/privacy-policy/. A setting controls whether the tick-box starts ticked. In the UK and the EU a pre-ticked box is not accepted as consent on its own, so make sure each person confirms by email (see below) and take advice if you are unsure.
Spam protection is built in: a hidden field that bots fill in and people never see, plus a limit on how many sign-ups one connection can make in ten minutes.
Confirmation emails (double opt-in)
Each person who signs up through a public form is asked to confirm by email before they are on your list. If you chose your site's own Subscribers list, your site sends that email itself, with a link that works for 7 days, and the person is only added when they click it. If you chose a provider, whether the email is sent depends on a setting inside the provider:
- MailerLite: go to Account settings, then Subscribe settings, and switch on Double opt-in for API and integrations. If it is off, MailerLite never sends the email and people are added straight away as Active.
- Kit: the form chosen by the form ID must have its confirmation email switched on.
- Brevo: your site sends its own confirmation email with a link, because Brevo does not do this for sign-ups added this way. The person joins your Brevo list when they click it.
- Mailchimp: Djangify asks for pending status. Check that a confirmation email arrives when you test.
- AWeber: your list's own confirmed opt-in setting decides. It is on by default.
Tick-boxes at checkout and registration are different: the person is already inside the order or sign-up, so they are added straight away.
Using your site's own Subscribers list and newsletters
On managed hosting, the built-in Subscribers list and newsletters are part of the Full plan. On the Lite plan, send sign-ups to your email provider instead. Self-hosted sites include both.
If you chose your site's own list, here is how it works.
- Who is on it: open Email Subscribers, then Subscribers. Each person is saved with the date, where they signed up and the wording they agreed to, which is your record of consent. You can filter by Subscribed or Unsubscribed and download the list as a CSV.
- Send a newsletter: open Email Subscribers, then Newsletters and add one. Write the subject and the email, and type {first_name} where the person's first name should go (people with no first name see "there"). Save, press Send newsletter, send a test to yourself first, then send.
- Sending speed: emails go out in small batches with a short pause, up to 250 a day by default. Check your email service's own daily limit as well, because your order emails share it. If a send stops part way, press send again and it carries on with the people who have not had it yet. Nobody gets the same email twice.
- Unsubscribing: every newsletter ends with an unsubscribe link and also carries the one-click unsubscribe that mail apps show as a button. Someone who unsubscribes is never added again by a later tick-box or form. Order and account emails still reach them, because those are not newsletters.
For a large list, or if you want automations, templates and open statistics, a provider is the better choice. You can switch the setting at any time.
Setting up a waitlist
- For a product that is not ready: set the product's status to Coming Soon. A sign-up box appears under the Coming Soon notice.
- Wording: change the title, message and button text under Site Settings, Email Settings, Waitlist sign-up, for example "Join the waitlist".
- Who is waiting for what: everyone who joins from a product is also tagged waitlist-product-name. In MailerLite that is a group of its own, so you can email exactly those people when the product goes live. On your site's own list, the Source column shows the waitlist.
- A waitlist not tied to a product, such as your next course: add a Waitlist block to any page and give it its own title, tag and, if you want, its own list.
Testing it
Sign up with a brand-new email address, for example a Gmail address with a tag such as name+test1@gmail.com. An address that is already an active subscriber is never sent a confirmation email again, which makes a test look broken when it is not. With a provider, a new subscriber should show as Unconfirmed until they click the link in the email. On your site's own list, the person appears under Subscribers once they click the link.
If someone says they signed up and nothing arrived
- Check where sign-ups are going. Read Where do email sign-ups go? in Email Marketing Integration. If it says your site's own Subscribers list, or no provider is connected, the person is under Email Subscribers, then Subscribers, not at your provider. A person from a public form only appears there after clicking the confirmation link. Someone who unsubscribed earlier is never added again.
- Look in the right place. In MailerLite, a form's own subscriber count only counts people who joined through MailerLite's own form. People from your site's form appear under Subscribers, then Groups, then your group.
- Check the ID. A form ID in a MailerLite account is the most common mistake. It needs the group ID.
- Check the API key is saved. It shows as dots after saving. If it is blank, or you saw a red error about ENCRYPTION_KEY, the site is missing its encryption key.
- Is the person already subscribed? If so they are not sent another confirmation email.
- Is double opt-in switched on at your provider? See the list above.
See also: Managing Email Optins for the opt-in tick-box on customer registration and the dashboard subscribe button.