Newsletter

How to turn on the Newsletter and collect subscribers

How to turn on the Newsletter and collect subscribers

To collect newsletter subscribers in TeleportHQ, open Plugins in the left sidebar, click Newsletter and turn on Newsletter enabled. Follow the Activate Newsletter window: TeleportHQ sets up your subscribers in the TeleportHQ database, a footer sign-up, a signup popup and a welcome email. Then connect your email provider in the Newsletter panel and publish your site. From then on, visitors can subscribe from your footer, the popup, any newsletter block, the sign-up form and the checkout.

Before you start

  • Plan. Writing and sending newsletters needs a Trial, Pro or Premium workspace.
  • Editing rights. In a project you can only view, the panel says "This project is read-only, so Newsletter cannot be switched on."
  • The Newsletter makes your project a web app. On a website, TeleportHQ first opens the Enable Web App features? window ("Activating Newsletter requires a Web App."). Nothing changes until you click Enable Web App features. See How to turn a website into a web app.
  • The TeleportHQ database. Subscribers are kept in the TeleportHQ database. If your project has no database yet, the activation creates it. On a trial, the window warns: "On your current plan the TeleportHQ database stays active for 7 days. After that it becomes inactive until you upgrade."
  • Who stays on your list. Switching the Newsletter on makes the people of your site who agreed to your emails subscribers. People who never opted in stop receiving newsletters and Marketing Studio campaigns until they subscribe. The activation window tells you how many before you confirm.
  • An email provider account, such as SendGrid, Resend, Mailgun, Postmark or MailerSend, with an API key. You can connect it after switching the Newsletter on.

Steps

1. Switch the Newsletter on

  1. In the TeleportHQ editor, in the left sidebar, click Plugins.
  2. In the Plugins list, click Newsletter ("Subscribers, sign-up points and the newsletters you send them."). Its settings open in a drawer beside the list.
  3. Under Feature, turn on the Newsletter enabled switch.
  4. If your project is a website, the Enable Web App features? window opens. Click Enable Web App features.
  5. The Activate Newsletter window lists the three things it sets up: Your subscribers, Sign-up points and Your first newsletter. Wait until the line below them stops saying "Counting the people on your site…". It then says, for example, "Everyone on your site who agreed to your emails is a subscriber."
  6. Click Continue. (If your project's sign-in or store already have a database, the button reads Activate Newsletter and the next step is skipped.)
  7. Under Select Database Type, keep the TeleportHQ database card ("Managed by TeleportHQ") selected, then click Continue.

The Setting up your newsletter window shows each step as it runs: Setting up your subscribers, Writing the newsletter emails and Switching Newsletter on. Keep the tab open. When it says Your newsletter is ready, click Done. The Newsletter panel opens, with its own Newsletter button in the left sidebar, and a message says "Newsletter has been activated successfully!"

A Newsletter is Ready! card offers a short tour. Click Show Me, or Maybe Later. To play it again, click the Newsletter Tutorial button (the info icon) at the top of the Newsletter panel.

You can also start from the panel: in the Plugins drawer, under Panel, click Open next to Newsletter panel, then click Activate Newsletter. To switch on several plugins at once, use Edit → Enable Plugins… in the Project Menu and tick Newsletter. That window always uses the TeleportHQ database. See How to turn features on or off (Plugins).

The TeleportHQ Newsletter panel before the Newsletter is switched on, with the Activate Newsletter button highlighted

2. Connect the email provider

Your newsletters and the welcome email go out through one email provider.

  1. In the Newsletter panel, under Email providers, click Add email provider. If a provider is already connected, its card shows instead: click it.
  2. In the Email provider drawer, click a provider: SendGrid, Resend, Mailgun, Postmark or MailerSend. One your project already uses is selected, with a Connected label.
  3. Under Credentials, paste your API Key (Postmark asks for a Server Token, and Mailgun also for a Domain, such as mg.mybakery.com). You can also link a key saved in your project's secrets.
  4. Under Sender, type the From name, for example Hearth & Crumb, and the From email, for example news@mybakery.com. Leave the email empty to use the address the provider already has.
  5. Click Save. You see "Email provider and sender settings saved."

The provider you save here becomes your project's email provider, the one Project settings → Credentials → Email Providers names. Your workflows and store emails send through it too. See How to choose which email and SMS provider your project sends through.

3. Check the welcome email

  1. At the top of the Newsletter panel, click the gear (Newsletter Settings). The Newsletter Settings drawer opens.
  2. Welcome email is on: "Sent automatically to every new subscriber once they join your newsletter." To stop it, turn the switch off.
  3. To change its words or design, click Edit the welcome email. The email opens on the canvas, and a Back to Newsletter settings button shows for a few seconds to take you back.

4. Publish your site

At the top right, click Publish and publish your site. The sign-up points and the welcome email reach your live site only after you publish: "Publish to apply: your live site gets these changes on its next publish." See How to publish a web app.

Where visitors subscribe on your TeleportHQ site

TeleportHQ calls the places where people join "sign-up points". After you switch the Newsletter on and publish, people can subscribe from:

  • Your footer. TeleportHQ adds a newsletter sign-up to your site's footer. If the footer already has a sign-up email box, TeleportHQ uses it instead of adding a second one. A footer with only a contact form gets no sign-up, and neither does a site without a shared footer.
  • The signup popup. A corner popup named Newsletter appears 12 seconds after a new visitor arrives, at most once every 30 days. In Newsletter Settings, its switch turns it on or off, Popup settings changes when and where it opens, and Edit the popup design opens it on the canvas. If your site has none, click Add a signup popup. You also find it in Growth → Marketing Studio → Popups. See How to create a popup for your site (Popups).
  • A newsletter block. Add the Newsletter Signup element (Elements → Primitives, under Site) or a newsletter section to any page. It asks for an email address and has a Subscribe button. After someone subscribes it says "Thanks for subscribing!"
  • The sign-up form, if your site has sign-up and login. An unticked Email me news and offers box appears before the sign-up button. A visitor who ticks it joins when their account is created. See How to add sign-up and login to your site.
  • The account page, if your site has sign-up and login. Signed-in visitors find a Newsletter section with Email me the newsletter, which they turn on or off.
  • The checkout, if your site has a store. A shopper who ticks Email Me Offers And News joins your newsletter. Switching the Newsletter on adds this box above the terms box of an older checkout page that lacks it. See What shoppers see: cart, favorites and checkout.

Growth shows where each subscriber joined, for example Footer sign-up, Popup or Checkout. See How to see, import and remove newsletter subscribers.

Confirmation emails (double opt-in)

The TeleportHQ Newsletter signs people up as soon as they submit their address: there is no confirmation step by default, and Newsletter Settings has no switch for one. Someone who unsubscribed before and signs up again is sent an email with a link to confirm instead; until they click it, Growth counts them as Waiting to confirm.

To ask every new subscriber to confirm by email (double opt-in), ask the AI Assistant, for example "Turn on confirmation emails for the newsletter". It needs an email provider, and it shows a card for you to confirm. Publish afterwards.

Check that it worked

  • The Plugins list shows On for Newsletter, and the left sidebar has a Newsletter button.
  • The Newsletter panel shows your provider under Email providers, with the sender name and address.
  • In Growth, a Newsletter heading with Subscribers appears.
  • After you publish, subscribe from your live site with your own address. It appears in Growth → Newsletter → Subscribers, and the welcome email arrives.

Troubleshooting

"Newsletter needs the TeleportHQ database, and the features of this project use another database. Connect the features to the TeleportHQ database to use Newsletter." Your project's sign-in, store or blog keep their data in another database, and the Newsletter works with the TeleportHQ database only. Activate Newsletter stays greyed out. Connect those features to the TeleportHQ database, then try again.

"Activating Newsletter requires a Web App." This is the Enable Web App features? window. Click Enable Web App features to go on, or Keep as a Presentation Website to stop.

"We could not count the people on your site; you can still switch Newsletter on — anyone who never opted in will stop receiving emails." TeleportHQ couldn't read your people before you confirm. You can go on: the activation sorts them out as it runs.

"You have reached the maximum number of Newsletter activations for this project." A project can switch the Newsletter on up to 10 times. To switch it on again, write to hello@teleporthq.io.

"Your newsletter could not be set up" "Something went wrong. Newsletter stays off; switching it on again picks up here." Switch it on again from Plugins.

A warning icon at the top of the Newsletter panel, or "Welcome email cannot go out" in Plugins "The welcome email is on, but no email provider is set up, so new subscribers are not welcomed." Connect a provider (step 2). If it says the sender address cannot send, change the From email in the Email provider drawer.

"Newsletter is on, but our server could not be told." "Sending will be refused until you switch Newsletter off and on again, or publish." Publish your site.

Turn the Newsletter off

  1. At the top of the Newsletter panel, click the gear (Newsletter Settings).
  2. At the bottom, under Disable Newsletter, type disable newsletter in the box.
  3. Click Disable Newsletter.

"This removes the newsletter pages and their workflows from the project and cancels the scheduled issues. Your subscribers and issues stay in your database." You can also turn off Newsletter enabled in Plugins → Newsletter. If you switch the Newsletter on again, the Activate Newsletter window says how many newsletters were canceled; schedule them again yourself.

Good to know

  • Bookings and forms don't add newsletter subscribers. Their Email me offers and news box saves the person as a contact who agreed to your marketing emails, for the Marketing Studio.
  • Imported people and people you add yourself don't get the welcome email.
  • Read-only projects. People you share a project with for viewing can't switch the Newsletter on or change it.
Share

Related Articles

What is the Newsletter plugin?

The TeleportHQ Newsletter plugin collects subscribers on your site (from a newsletter block, your footer, a signup popup, your sign-up form and checkout), welcomes them by email, and lets you write, test, plan with AI, send and schedule newsletters through your own email provider.

How to write, test and send a newsletter

In the TeleportHQ Newsletter panel, click + (New Newsletter), fill in the name, subject and preview text, write the email yourself or with Generate with AI, click Create Newsletter, send yourself a test with Send a test, then click Send now or pick a time in When it goes out and Save to schedule it.

How to see, import and remove newsletter subscribers

In TeleportHQ, open Growth → Newsletter → Subscribers to see who joined your newsletter and where, search and filter the list, import people from a CSV or JSON file (including Mailchimp, Substack and other exports), export them, unsubscribe or delete someone, and see under Results how each newsletter you sent did.

How to choose which email and SMS provider your project sends through

In the TeleportHQ editor, click the Project settings cog, open Credentials → Email Providers or SMS Providers to see which provider your project sends through and where it's used, add a provider's credentials, and click Use for this project to switch every workflow step to it.

How to create a popup for your site (Popups)

In the TeleportHQ Marketing Studio, open Popups, click New popup, choose what it is for (a newsletter signup, a discount code, something you sell, an announcement or anything else), pick a layout and a ready design or let AI write it, click Create popup and publish your site; by default visitors see it when the pointer leaves the page on a computer, or after 20 seconds on a phone, at most once every 7 days.

How to turn features on or off (Plugins)

In the TeleportHQ editor, click Plugins in the left sidebar, click a plugin such as Blog, Bookings or Authentication, and flip its "enabled" switch in the drawer that opens; the same drawer starts its tutorial, opens its panel, shows or hides its left-sidebar button and lists what needs attention, and flipping the switch again and confirming turns it off.