Open this in Magpie

Choose Write an email on the Newsletter page. Enter a Subject and optional Preview text (shown beside the subject in many inboxes). Under Text, choose where the email's text comes from:

  • Write it here: the Email body in Markdown. HTML in the body is removed before sending.
  • Use a Document: one of your team's Documents. The email sends the Document as it reads when you save, send or schedule the email, with its headings, formatting and pictures. Text you wrote here is saved with the draft in case you switch back.

Save draft keeps it while you work. Pressing it twice, or going Back to the page and saving again, saves the same draft rather than making a second one.

If a save or send does not go through, for example because you were signed out or the page was open for a long time, the page comes back holding what you typed, says why, and asks before you leave it. If the draft was saved somewhere else while you were writing, in another tab or by someone else, your save or send is stopped rather than replacing their version: the page keeps your text, and saving or sending again from it keeps yours instead. Reload the page to see the other version first.

Pictures are at most the width of the email and 600 pixels high, keeping their shape, and subscribers receive copies resized for that size.

Design

Leave Design HTML empty for the Newsletter's usual look. To give the email its own design, paste HTML into Design HTML, with {content} where the email's text goes. A <style> rule for a tag name, such as h1 or p, is written onto those tags, because many mail programs drop style sheets. Scripts, forms and frames are removed. A font from Google Fonts can be loaded with an @import in the <style>; many mail programs show the fallback font after it instead.

To have a chatbot write the design, choose Use a chatbot…. Copy its instructions into any chatbot; they include the email's current design (or the Newsletter's usual look, before it has one), and ask the chatbot to change only what you ask for. Then say what the email should look like ("a white background, our logo at the top from https://example.com/logo.png, dark blue headings"). You can paste the email's text or pictures of it, so it sees what the design will hold. Paste the chatbot's answer into Import JSON…, which starts on The design only: the design is used and the email's text stays exactly as it is, even if the chatbot sent back a copy of the text with changes. Choose The design and the text to use its subject and text too; if that text's words differ from the text it replaced, the message after the import says so. Magpie sends nothing to the chatbot itself.

The footer with the unsubscribe link is always added under a design. Once the draft is saved, Preview shows the email as subscribers will receive it.

Test, import and export

Send a test… sends the draft to up to 10 addresses you type, separated by commas or new lines, so you can check it in different mail programs. It is marked as a test. If something the email needs is missing, such as its subject, the page says so after you press it.

Export JSON, in More, downloads the draft's subject, design and text (or the Document it uses) as one file. Import JSON… reads such a file, or JSON written by a chatbot: each part in it replaces the draft's, and a part left out stays as it is. For example, a chatbot's answer:

{"subject": "Autumn news", "design": {"html": "<table>…{content}…</table>"}, "body": {"markdown": "## Hello"}}

Send or schedule

Under Delivery, choose Send now or Schedule. A scheduled time is in the time zone shown under the field, and sending starts within a minute of it. The page names how many subscribers would get the email, and asks you to confirm before it is sent or scheduled.

An email sent now waits 5 minutes before any copy goes out. Its page counts the time down, and Cancel sending, beside its name, puts it back as a draft with nothing sent, so you can change it and send it again.

The recipient list is fixed when you send or schedule: subscribers who join afterwards do not get that email. A subscriber who unsubscribes, or whose address bounces on an earlier email, before their copy goes out is skipped.

Plan limits apply to the number of subscribers and to email sent in a month.

The email's page

Every email has its own page, opened from Not sent yet or Sent on the Newsletter page. It shows its status, who wrote it, how many copies were delivered, failed and skipped, and the email as subscribers received it (or a preview of a draft). From there:

  • Edit draft opens a draft again.
  • Cancel sending, during the 5 minutes after Send now, puts the email back as a draft.
  • Cancel email, in More, stops a scheduled or queued email before delivery begins; it goes back to being an unsent record.
  • Delete draft, in More, deletes an unsent draft.
  • Web copy opens the public page of a sent email, when Web copies is on in Settings.
  • Share to Social Media, beside Web copy, makes a Social Media post with the email's subject and web copy address and opens it (see Write, schedule and publish social posts).

Once sending has started, an email cannot be recalled or edited.

If sending stops partway through a copy, Magpie cannot tell whether that copy went out, so it is not sent again: the email's page says how many copies may have gone out, and counts them as failed.

In the native app

The native app writes and edits drafts in Markdown, shows the email history, and has Save and send now, which asks for confirmation, and Save draft, which keeps the draft without sending. If saving succeeds but sending fails, the draft stays. A saved draft's action menu sends a test to your account email address or schedules delivery; save edits first. Enter the date and 24-hour time in your account time zone, then confirm.

A sent email with a web copy has Share web copy and Copy address in its action menu, and Share to Social Media, which makes a Social Media post with the email's subject and web copy address and opens it. The Newsletter screen shows the Sign-up page address with Share address and Copy address.

If a test looks wrong, fix the draft rather than the sent web copy. If a scheduled email is still waiting after its time, or canceling is refused before sending has begun, Contact support.

Ask Magpie support

Send Magpie staff a question about anything this article does not answer.