Pick an AI writer, choose your stories, and HeyNews writes a full newsletter draft.
Before you generate
You'll need:
At least one ready AI Writer. Connect a newsletter during setup and wait for the ready email. You can check its progress under Voice & past issues.
At least one story selected. Browse and select from your story library.
If your AI Writer came from an approved Newsletter Format, select a ready Sending Connection before creating more Drafts. For beehiiv, connect draft publishing, choose its destination Publication, and select Use for new provider drafts. A ready Kit connection also meets this requirement, but you still copy your finished Issue into Kit. Importing a public archive or adding a beehiiv API key alone does not complete this step. Your Demo Issue stays available to review.
Step-by-step
Go to Compose in the sidebar
Choose your AI writer. If one writer is ready, Compose selects it for you. If several are ready, Compose asks which one you want before opening the story workspace. Use Change writer in the header if you need to switch.
Browse stories in the story pool. Compose starts with Stories published since that AI Writer's last Draft. If the Writer has no Draft yet, it starts with the last 7 days and widens the range when fewer than three Stories are available. Use the date button for another preset, a custom rolling window, or calendar dates. Your non-calendar choice stays with that AI Writer and is shared with collaborators. Calendar dates last for the current visit only. Use Filters to include previously used Stories or change how many appear per source. Stories you already selected stay visible when filters change.
Click stories to select them for your newsletter. You can also use Select all / Deselect all in a source group, click Select Best to let AI pick stories for each part of your newsletter, or choose Add stories from links to paste a prepared list. After Select Best, choose Undo if you want to restore your previous selection.
Click Write Draft below your selected stories. Add an optional Draft Brief when you want this issue to emphasize a theme, connect two stories, or take a specific angle.
A Draft Brief applies only to the draft you are about to write. HeyNews clears it before your next draft, so you can give one issue special direction without changing your AI Writer. HeyNews still uses only the Stories you selected for facts and links.
Add stories from a link list
Choose Add stories from links when your research already lives in a spreadsheet, document, Slack message, CSV, TSV, or plain text list. Paste the whole block. HeyNews finds links in any column and ignores the surrounding notes, labels, and empty cells.
Review the detected links, then choose Add stories. Existing Stories are selected without fetching them again. New links become one-off Stories, so HeyNews does not follow those sites for future content. The combined selection can contain up to 50 Stories.
If HeyNews cannot review the links right now, it keeps the pasted list in place. Wait a moment, then choose Review links again.
You can close the import window or leave Compose while HeyNews works. Reopen it to check progress, retry temporary failures, cancel pending work, or continue with the Stories that are ready. Compose keeps Write Draft unavailable until that decision is settled.
Some sites block automated readers even though the article opens normally in your browser. When that happens, open the article in Chrome and use the HeyNews extension's Save as story action. After it saves, you can add the Story to Compose. HeyNews uses your open Compose session when one is available. If no session is open, it starts a new one. Opening the extension while you are composing keeps the current Publication available for 30 minutes after you leave Compose, so you can clip a few related articles. If Compose is for another Publication, HeyNews opens a new Compose tab for the Story's Publication instead.
Copy page as Markdown can also save the page and add it to Compose. Choose Save and add to Compose after copying when you want the page in your draft.
Generation runs in the background and typically takes 30-60 seconds. While it works, Compose shows the AI Writer, the locked input summary, and the draft generation being used.
HeyNews gives your AI Writer the intended issue date in your publication timezone. This helps weekday-specific wording match the issue, even when the draft is prepared on a different day.
Your AI Writer also looks at a few past issues when it writes. If your publication has more than one source of past issues, HeyNews can include an older example from a source that recent issues would otherwise hide. These examples help it keep details such as humour, emoji habits, paragraph rhythm, and sign-offs without copying old sentences. Subject suggestions use past subject lines in the same way. If there are no suitable past issues, Draft Creation continues normally with the AI Writer's Voice Profile.
Navigate away during generation
You don't have to wait on the Compose page. If you navigate away while a draft is generating, HeyNews keeps working in the background, saves the result to Issues, and shows a message when the draft is ready. Look for the New badge there.
If you come back to Compose while generation is still running, a banner at the top shows you the job is in progress.
Automated drafts
Use Automations in the sidebar to create drafts on a schedule. Pick a ready AI Writer, select one or more Issue Days, choose when to create the drafts, then set the time, timezone, and a cadence from one to four weeks. HeyNews will:
Select eligible stories with Smart Select
Write the draft
Generate a subject line and preview text
Save the result to Issues
Notify you by email and in-app notification
Automations never send or publish a newsletter. You still review the draft in Compose before copying, publishing, or sending it.
Issue Days and draft creation stay separate. A Friday issue prepared one day early starts on Thursday, while the AI Writer receives Friday as the issue date. The calendar preview shows both dates in the automation timezone.
If a temporary service problem interrupts draft creation, HeyNews retries every five minutes for up to 30 minutes. A paused or deleted automation cancels the unfinished draft. Missed Issue Days are not created later.
Each automation can set a minimum story count, maximum story count, date window, and whether used stories can be reused. The date window offers the same choices as Compose, apart from calendar dates, and new automations start on Since last draft. HeyNews picks from the eligible stories available when the automation runs. Standard automations do not lock drafts to one fixed source list; managed Company Newsletter automations may stay tied to the sources approved during setup. If there are not enough matching stories, HeyNews skips the run and explains why instead of creating a weak draft. If the same setup keeps failing, HeyNews pauses the automation until you review it.
For a full walkthrough, see Automated Drafts.
Previously used stories
Compose hides stories you've already used so your next issue starts with fresh options. If your search only matches stories you've used before, Compose shows a Show used stories button. Click it when you want to reuse or reference an older story.
If you send stories from Content Desk into Compose, they stay selected even if they sit outside the current date or source filters. That makes it safer to adjust filters without losing the stories you already picked.
The generated draft
Once generation finishes, you'll see:
Subject line for the email inbox.
Preview text for the short inbox snippet.
Subtitle, an optional line beehiiv shows under the post title. You write this one yourself. If you leave it blank, beehiiv uses your preview text.
Draft copy with a Visual and Markdown editor.
Stories used, a locked list of the story titles and source names that created the draft.
Your story and source choices are locked after a draft is created. To use different inputs, start a new draft. That uses another draft generation from your plan.
The draft title is created automatically from your writer name and the current date (e.g., "Weekly Tech Roundup - Friday, March 21").
HeyNews also checks measurable Style Rules, such as Never use '-' and Summaries are 200 to 260 characters. For a summary length rule, it counts the visible text in each paragraph that contains a Story link. A rule scoped to one Section checks only that Section. If the first draft misses one of these rules, HeyNews tries one repair. If the repaired draft still misses it, HeyNews saves the draft and shows a warning so you can review it. These style warnings never override Story and link safety checks.
Editing your draft
Direct editing
Edit the subject line, preview text, subtitle, or draft copy directly. Changes stay on screen as you work, but they are not saved to Issues until you click Save changes.
Refine with AI
Use Refine with AI to request changes in plain language:
"Make the intro shorter"
"Add a section about the funding round"
"Change the tone to be more conversational"
"Remove the third story"
"Make the whole thing 20% shorter"
Choose Edit Draft for changes like these. Choose Ask a question when you want an answer in chat, such as "What is the main point?" The answer leaves your Draft as it is. If you type a question in Edit Draft and say "do not edit the draft", HeyNews asks whether to send it as a question first, and you choose. On an ordinary Draft, each question counts as one AI revision. If your account uses credits, it costs one credit, just like an edit. Cancelling while the request is still waiting, or in the first ten seconds after your AI Writer starts on it, gives that revision and credit back.
On a credit-funded Newsletter Format, these questions use the included review messages first. An included message costs nothing. Cancelling before the answer arrives gives it back. After those messages are used, each later message costs one credit. Answers can include lists, links, and quotes. They stay in chat, not in your Draft.
Unless you ask to rename a heading, Refine with AI keeps every Markdown heading exactly as it appears. To change one, name the heading in your request.
The AI revises the draft in the background. You can refresh the page or move elsewhere in HeyNews while it works. When you return to Compose, HeyNews restores the refinement in progress or applies the finished copy as unsaved changes for you to review. For a question, your answer appears in chat when you return. The Draft stays locked until the request finishes so another edit cannot overwrite it. While it runs, the Draft Review header explains the read-only state, shows when the refinement started, and keeps Cancel refinement available. If the refinement fails, your previous copy stays intact and becomes editable again.
Subject and preview suggestions
Use Ideas for subject line options, or Suggest both to generate a new subject line and preview text together. Applying a suggestion creates unsaved changes, just like manual editing.
Suggestions follow patterns HeyNews can see in your past subject lines, including emoji and punctuation. When there is no clear pattern yet, HeyNews defaults to subject lines without emoji or exclamation marks.
Revision limits and the 100 AI revisions per draft add-on
The 100-revision allowance is a total for each draft, not 100 extra revisions or a monthly reset. Revisions you've already used still count after an upgrade. At 100 revisions, you can keep editing the draft manually.
Each draft has a refinement limit based on your plan. Free trial and Hobbyist accounts get 5 AI refinements per draft. Starter gets 10, Pro gets 20, and Team includes 100 AI revisions per draft.
You'll see a running counter in the refinement panel so you know how many you've used.
Cancelling is free while the request is still waiting, and stays free for the first ten seconds after your AI Writer starts working. Cancel after that and the revision counts because your AI Writer has already spent time on the request. The confirmation box tells you which one applies before you confirm, and you get a short note afterwards saying whether anything was used. Either way, a cancelled revision is gone for good: you can't come back to it later. Closing the tab or moving to another page isn't cancelling. Your revision keeps running and the result is waiting when you return.
What happens at the limit depends on where you are:
During the free trial, HeyNews offers to start your subscription right away, on the plan you picked at signup, with the exact amount due shown before you decide. Confirming ends the trial that day, charges your saved card for the amount shown, and applies the paid plan's revision limit. Starter, Pro, and Team give the current draft more revision capacity. Hobbyist stays at five revisions and offers 100 AI revisions per draft after the subscription starts. Declining changes nothing, and your trial keeps running.
On Hobbyist, Starter, or Pro, a prompt offers the 100 AI revisions per draft add-on ($50/month or $420/year), which raises the total to 100 AI revisions per draft. Add it from Account settings > Subscription > Add-ons, and refinement unlocks right away without a page refresh. Remove the add-on anytime from the same page.
Draft actions
After a draft is written, the draft workspace gives you:
Visual / Markdown toggle to switch between direct and source editing
Refine with AI to ask for changes
Copy to copy the full issue, subject line, or preview text
Create draft in beehiiv or Create draft in Kit when that platform is the selected, ready Sending Connection
Save changes to save edits to Issues
Discard changes to return to the last saved version
Stories used to see the readable locked inputs that created the draft
Image search to find and insert images into your newsletter
Saving and exporting
Click Save changes to store your edits. A newly generated draft appears in Issues with a New badge. Once you save edits, it appears as Edited.
To use the issue in any email platform, open Copy, choose Copy full issue, and paste the content where you send from. Copy uses the version currently on screen, including unsaved edits. If you connected beehiiv for draft publishing, select it as the Sending Connection, save your changes, and use Create draft in beehiiv. HeyNews creates a post draft and checks it. You review and publish it in beehiiv. With Kit selected, Create draft in Kit creates an unsent Kit broadcast draft the same way, where that option has been turned on.
If you try to leave Compose with unsaved changes, HeyNews asks you to save or discard first.
Generation limits
Free trial gives you 5 drafts total (during the 14-day trial).
Hobbyist gives you 5 drafts per month.
Starter gives you 15 drafts per month.
Pro gives you 45 drafts per month.
Team gives you 90 drafts per month.
Each generation attempt counts toward your limit, whether you save the result or not.
Section story counts
Each section of your AI Writer can have its own story count. These counts set the most Stories HeyNews should use in that section. A "Top Stories" section set to 5 can use up to 5 Stories, while a "Quick Hits" section set to 2 can use up to 2. If your selected Stories do not support a section, HeyNews leaves it out instead of filling it with unrelated material.
A section with a story count of 0, such as an editor's note or a closing thought, doesn't need a Story link. HeyNews writes it in your voice. It can name Stories covered in other sections without linking to them.
Section names and descriptions also guide where your selected Stories go. A specific description helps the AI Writer place a Story when several sections cover similar topics.
Before saving a generated draft, HeyNews checks that its article links come from the Stories you selected and that every included section with a story count above 0 has source material. It also blocks generated images, raw HTML, unrelated links, repeated Stories across sections, and placeholder content, even when a placeholder is wrapped in a valid Story link. You can still add an image after generation with Image search.
Your AI Writer can still use the closing lines that make the newsletter yours, including sign-offs, invitations to keep reading, and mentions of your other newsletters. By default, generated drafts leave out sponsor spots and ads. A call to action is only linked when its URL comes from a selected Story or an approved reusable link.
If your newsletter always uses the same Publication home or CTA link, add it to the AI Writer's Reusable Links card. Approving a link does not force it into every draft. It makes the destination available when the Writer's voice and the draft call for it. Links in historical examples do not carry over to a new Draft unless you approve them or they are already approved in the Voice Profile.
HeyNews follows the link placement learned by your AI Writer. When your Voice Profile has no clear pattern, it uses inline links. Your AI Writer is asked to link each item to the selected Stories it covers, even when past issues cited more sources. HeyNews checks generated link destinations against selected Stories and approved Reusable Links. It also asks your AI Writer to leave out past header and divider images and use a text section heading where an image marked a section.
If the first result fails these checks, HeyNews rewrites it with the approved links. When a backup generation model is available, HeyNews can make one final safe rewrite before stopping. If that final rewrite adds an unapproved link, HeyNews restores the correct link when the wording exactly matches one selected Story title. Other unapproved links become plain text before HeyNews checks the full Draft again. When the link wording is itself a web address, removing the link would still leave that address in your issue, so HeyNews stops instead. It saves the Draft only when every source check passes. Otherwise, HeyNews saves nothing and tells you to review the selected Story links or Reusable Links before trying again.
Tips for better results
Select relevant stories. The AI works with what you give it. Pick stories that fit your newsletter's theme.
Use a trained writer. Writers with more past issues to learn from usually produce more consistent results.
Make length rules specific. Add a numeric character range to a Style Rule and name the Section when it should apply to only one part of your newsletter.
Use Refine with AI. Don't try to get it perfect in one shot. Generate, then ask for changes in the refinement panel.
Mix story types. A newsletter that's all hard news gets tiring. Throw in some analysis or lighter pieces too.
