What is the Newsletter plugin?
The Newsletter plugin is TeleportHQ's built-in mailing list. Once you switch it on, visitors can subscribe on your published site: from a newsletter block, your footer, a signup popup, the sign-up form and the checkout. TeleportHQ sends each new subscriber a welcome email. You write newsletters in the editor, or let AI write one or plan a whole series, then send them right away or schedule them. Everything goes out through your own email provider, such as SendGrid or Resend.
What the TeleportHQ Newsletter adds to your site
When you switch the Newsletter on, TeleportHQ sets up:
- Your subscribers. They are kept with the other people of your site (the people who sign up or buy), in the TeleportHQ database. Each one is Subscribed, Unsubscribed or, if they still have to click a confirmation link, waiting to confirm.
- Sign-up points, the places on your site where people join:
- The footer sign-up. TeleportHQ adds a newsletter sign-up to your site's footer, or uses the email box your footer already has.
- The signup popup. A small corner popup named Newsletter that invites new visitors to subscribe, 12 seconds after they arrive, at most once every 30 days.
- The newsletter block. The Newsletter Signup element, in Elements → Primitives, and the newsletter sections. Place them on any page.
- The sign-up form box. With sign-up and login on, the sign-up form gets an unticked Email me news and offers box.
- The checkout box. With a store, a shopper who ticks Email Me Offers And News at checkout joins too.
- The account page switch. With sign-up and login on, signed-in visitors can turn Email me the newsletter on or off on their account page.
- The welcome email, sent through your email provider to each new subscriber. It's on by default, and you edit its design like any other email.
- The newsletter layout, the email design that a newsletter you write by hand goes out in.
Switching the Newsletter on doesn't publish anything. Your live site gets the sign-up points and the welcome email after you publish. See How to turn on the Newsletter and collect subscribers.
What you need for the TeleportHQ Newsletter
- A Trial, Pro or Premium workspace. Writing and sending newsletters and reading the subscriber list need an active trial or a paid plan. Without one, the Newsletter panel says "Newsletters are a paid feature".
- A web app. The Newsletter needs a server, so switching it on in a website first asks you to make the project a web app. See What is a web app in TeleportHQ?.
- The TeleportHQ database. Subscribers and newsletters are kept there. If your project's sign-in or store already use another database, the Newsletter can't be switched on.
- An email provider, such as SendGrid, Resend, Mailgun, Postmark or MailerSend. Your newsletters and the welcome email are sent through your own account with it, and that company bills you for sending.
- AI tokens, only for what AI writes. See the table below.
Where you work with the Newsletter in TeleportHQ
| Place | How to open it | What you do there |
|---|---|---|
| Plugins → Newsletter | Plugins in the left sidebar, then the Newsletter row | Switch the Newsletter on or off, and open its panel. |
| The Newsletter panel | The Newsletter button in the left sidebar, shown while the Newsletter is on | Connect the email provider, write, test, send and schedule newsletters, and use Generate a run to plan several with AI. The gear (Newsletter Settings) holds the welcome email and the signup popup. |
| Growth → Newsletter → Subscribers | Growth in the left sidebar | See who joined, import and export subscribers, take someone off the list, and see how each newsletter you sent did under Results. |
| Your admin panel | Your published site's admin panel, if it has one | The Newsletter group has Newsletters and Subscribers: your team can write and schedule newsletters and unsubscribe people there. Sending right away and test emails stay in the editor. |
| Project settings → Credentials → Email Providers | The Project settings cog at the bottom of the left sidebar | The same email provider the Newsletter sends through, shared with your workflows and store emails. See How to choose which email and SMS provider your project sends through. |
How TeleportHQ sends a newsletter
- One email provider sends everything. Every newsletter and the welcome email go out through the provider you connect in the Newsletter panel. It's also your project's email provider, so your workflows and store emails use it too.
- Send now or later. Send now emails your subscribers right away. A time in When it goes out, at least 30 minutes ahead, sends it then. See How to write, test and send a newsletter.
- Limits. A project can have up to 5 newsletters scheduled at a time, and up to 2 on the same day.
- Every newsletter has an unsubscribe link. People who use it are marked Unsubscribed and get no more newsletters, campaigns or other marketing emails from your site.
- Numbers. Each sent newsletter shows how many people received it, how many it was delivered to and what share opened it.
How the Newsletter differs from the Marketing Studio's emails
TeleportHQ has two ways to email people. Both send through the same email provider.
| Newsletter plugin | Marketing Studio → Email | |
|---|---|---|
| Who receives it | The people who subscribed to your newsletter, or the subscribed people on one of your contact lists | Your contacts: everyone, one list or one address |
| How people get on it | They subscribe on your site, or you import them | They are the people of your site: newsletter subscribers and people who signed up |
| Writing | In a form, from a design you saved, or with AI, one at a time or a series | Email designs written by AI |
| Sending | Right away, or scheduled | Right away |
Use the Newsletter for a regular newsletter that people chose to receive. Use the Marketing Studio for one-off emails and multi-step campaigns. See What is the Marketing Studio?.
AI tokens used by the Newsletter
When an AI action starts, TeleportHQ checks that your workspace has at least this many AI tokens and holds them back. When the action ends, you're charged what the AI really used, which is often less.
| Action | AI tokens held back |
|---|---|
| One newsletter written with Generate with AI | 800 |
| A plan from Generate a run (Propose issues), for each day of the week you picked | 600 |
| Each draft the plan writes (the button reads, for example, Create 4 drafts) | 800 |
Switching the Newsletter on may also use some AI tokens to place the footer sign-up and match your footer's style. Without enough tokens, TeleportHQ places it without AI. See What uses AI tokens, and how much?.
Good to know
- Switching the Newsletter on settles who is on the list. People of your site who already agreed to your emails become subscribers. People who never opted in stop receiving your newsletters and Marketing Studio campaigns until they subscribe. The Activate Newsletter window counts them before you confirm.
- The AI Assistant knows the Newsletter. You can ask it to switch the Newsletter on, write or plan newsletters, list or add subscribers, or change the newsletter settings. Before it changes the settings, it shows a card for you to confirm.