Newsletter

How to write, test and send a newsletter

How to write, test and send a newsletter

In TeleportHQ, you write a newsletter in the Newsletter panel: click + (New Newsletter), give it a name, a subject and a preview text, and write the email yourself or click Generate with AI. Click Create Newsletter to save it as a draft. Then send yourself a copy with Send a test, and click Send now to email your subscribers, or pick a time in When it goes out and click Save to send it later. It goes out through your project's email provider.

Before you start

  • The Newsletter is on, with an email provider connected in the Newsletter panel. See How to turn on the Newsletter and collect subscribers.
  • A Trial, Pro or Premium workspace. Without one, the panel says "Newsletters are a paid feature".
  • AI tokens, if AI writes the newsletter: TeleportHQ holds back 800 for each one.

Steps

1. Start a newsletter

  1. In the TeleportHQ editor, in the left sidebar, click Newsletter.
  2. Next to Newsletters, click + (New Newsletter). While the list is empty, you can also click New Newsletter under "No newsletters yet". The New Newsletter form opens beside the panel.
  3. Fill in:
    • Name: how you find it in the list, for example November news.
    • Subject: what the inbox shows first, for example Our winter loaves are back.
    • Preview text: the line under the subject in the inbox, for example Three new breads, and Saturday tastings.
    • Send to: Your subscribers ("Everyone who subscribed to this newsletter."), or one of your contact lists. A list only reaches the people on it who subscribed.
    • When it goes out: leave it empty for now. See step 4.

2. Write the email

Under The email, choose how:

  • Write it manually ("Write the email yourself in this form. It goes out inside your newsletter layout."): type in the editor under it, which says "Write your newsletter…". You can use headings, lists, quotes and pictures.
  • Use a saved design ("Send a design you already built, including the one made for this newsletter."): pick a design under Choose a design. Click View on canvas to change it in the editor; a Back to newsletter edit button shows for a few seconds to bring you back.

To let AI write it:

  1. At the top of the form, click Generate with AI. The Generate Newsletter with AI window opens.
  2. Under What should the newsletter be about?, describe it, for example Announce our winter loaves and the Saturday tastings, with a 10% code for subscribers.
  3. Optional: under Add context (optional), tick up to 5 products, blog posts or bookable items for the AI to feature. Search them with Search products, posts and bookable items, or use the Products, Blog posts and Bookable items tabs, shown when your site has them.
  4. Click Generate Newsletter. "Uses about 800 AI credits."

TeleportHQ writes the name, subject, preview text and email, and builds a design for it. The form then shows it under Use a saved design, and the newsletter is saved as a draft. On a newsletter you already wrote, Generate with AI replaces its subject, preview text and email.

When the form is ready, click Create Newsletter (for a newsletter you're editing, Save). Its card appears in the panel with a Draft badge.

3. Send yourself a test

  1. Click the newsletter's card, if its form isn't open.

    The sending part of a TeleportHQ newsletter draft, with 1 the Send a test button and 2 the Send now button numbered
  2. Under Send a test, check the address. It starts with your own, for example you@example.com. "Sends one copy of this newsletter to the address below. Your subscribers are not emailed."
  3. Click Send a test. You see, for example, "Test sent to you@example.com. Only that address received it." Its subject starts with Test:.

4. Send it now, or schedule it

To send it right away:

  1. Under Send to subscribers, click Send now.
  2. The Send this newsletter? window says who it emails, for example "Send it to 120 subscribers now?". Click Send now.

The form says "Sending now — the numbers fill in as it goes." The card shows Sending, then Sent.

To send it later:

  1. In When it goes out, pick a date and time at least 30 minutes from now. The time is in your computer's time zone.
  2. Click Save (for a new newsletter, Create Newsletter schedules it right away).

The card shows Scheduled and the time, for example "Scheduled Nov 20, 09:00", with how many subscribers it will reach. To keep it as a draft instead, click Cancel schedule, or clear When it goes out and click Save. Send now on a scheduled newsletter sends it right away and drops the planned time.

Check that it worked

  • The card in the Newsletter panel shows Sent, the date, and for example "118 recipients · 42% opened".
  • Click the card to see Recipients, Delivered, Opened, Bounced, Complaints and Unsubscribed. The form says, for example, "Sent Nov 20, 09:00. A sent newsletter is kept as it went out."
  • Growth → Newsletter → Subscribers → Results lists every newsletter you sent, with its open rate. See How to see, import and remove newsletter subscribers.

Troubleshooting

"Connect an email provider first", or "Set up an email provider in the Newsletter panel before sending a test." No email provider is connected. In the Newsletter panel, under Email providers, click Add email provider. See How to turn on the Newsletter and collect subscribers.

"Add the address newsletters are sent from, in the Newsletter panel, before sending a test." Your provider has no sender address. Open it under Email providers and fill in From email.

"Give this newsletter a subject before sending." or "This newsletter has no content yet." Fill in Subject, or write the email, then try again.

"That time is too soon: pick one at least 30 minutes from now, or send it now." Pick a later time, or click Send now.

"This project already has 5 scheduled newsletters. Cancel one before scheduling another." A project can have 5 newsletters waiting at once. Open one and click Cancel schedule, or wait until one is sent. The newsletter you tried stays a draft.

"Two newsletters are already scheduled for that day. Pick another day." Up to 2 newsletters can go out on the same day (counted in UTC). Pick another day.

The card says Failed or Partly sent The card says why. For example:

  • "No recipients — nobody is subscribed yet."
  • "The daily sending limit was reached. Send again tomorrow to reach the rest."
  • "Your email provider refused to send (its account, credits, key or sender verification). Fix it with the provider, then Send again to reach the rest."
  • "Missed its time": a scheduled newsletter that couldn't go out on time.

Fix the cause, open the newsletter and click Send again. A newsletter that reached some people sends only to the rest: "nobody gets it twice."

"That audience no longer exists. Choose your subscribers and send again." The contact list in Send to was deleted. Choose Your subscribers or another list.

Good to know

  • A sent newsletter can't be changed or deleted. Only a Draft or Canceled newsletter has a trash button (Delete newsletter). To send a similar one, start a new newsletter.
  • Your newsletter layout. A newsletter you write by hand goes out inside your newsletter layout, an email design TeleportHQ made when you switched the Newsletter on, with your site's name. Saved designs are kept in the Newsletter folder of your email templates.
  • Unsubscribe link. Every newsletter has an unsubscribe link. People who use it are marked Unsubscribed and skipped from then on.
  • Several languages. On a multilingual site, a Language list under The email picks the language the newsletter is sent in.
  • Switching the Newsletter off cancels scheduled newsletters. Switching it on again doesn't schedule them again.
  • Your admin panel. If your site has an admin panel, your team can write and schedule newsletters under Newsletter → Newsletters (times there are in UTC). Sending right away and test emails work only in the editor.
  • Several at once. To have AI write a series, for example one a week for a month, see How to plan a series of newsletters with AI.
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 turn on the Newsletter and collect subscribers

In TeleportHQ, open Plugins → Newsletter, turn on Newsletter enabled and follow the Activate Newsletter window; then connect your email provider in the Newsletter panel, check the welcome email and publish, so visitors can subscribe from your footer, the signup popup, newsletter blocks, the sign-up form and checkout.

How to plan a series of newsletters with AI

In the TeleportHQ Newsletter panel, click Generate a run, pick up to three days a week, how many weeks and the time, choose the posts, products or pages to write about, click Propose issues, review the AI's plan, click the Create drafts button (for example Create 4 drafts) to have every newsletter written, then Schedule all.

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.

What uses AI tokens, and how much?

In TeleportHQ, every AI feature uses AI tokens for the AI work it really does, so costs vary; as a guide, an AI website page is about 3,000 tokens, a web app page about 15,000, a new section at least 1,500 and a 4-second AI video about 9,000, while stock images cost nothing, a run that fails before the AI works costs nothing, and AI 3D models aren't available yet.