The Format Generator helps you start a newsletter when you do not have past issues for Voice Training. You describe what you want to publish, then HeyNews researches the subject and builds a Newsletter Format for you to review.
This feature may not be available to every account while it is rolling out.
Complete the Format Intake
Choose Create a new newsletter during setup. The intake has three short pages with clear Back and Continue buttons. You will describe:
the newsletter you want to create, who will read it, and what it should do for you
what you already publish and which sources you follow
who will write and approve the newsletter, plus any writing samples you want to share
For each place you already publish, such as a blog or a podcast, you can add up to five links, a few words about it, or both. A description is the way to include work that has no link, like a printed column or a private community. Choose Other for anything the list doesn't cover, and add a link or a description so HeyNews knows what it is. If you haven't published anything yet, choose Nothing yet.
Share writing samples
Writing samples are optional. You can add up to 10, and each one is a link, a piece of pasted text, or a document. For every sample, choose whose writing it is:
My writing is something you wrote. HeyNews learns your voice from it.
Writing I like is someone else's work, like a newsletter you admire or a former colleague's piece. HeyNews uses only the qualities you point out and never copies that writer.
Add a note to say what HeyNews should take from a sample, such as the short openings or the way it explains numbers. Move up and Move down change the order. All your pasted samples together can hold up to 20,000 characters.
HeyNews doesn't open sample links, so the link and your note are all it sees. To share the words themselves, paste the text or upload a document. Samples only shape how your newsletter reads. They never become sources for your stories.
To use a document, choose Document as the sample type, then Choose a document. HeyNews reads PDF (.pdf), Word (.docx), Markdown (.md or .markdown) and plain text (.txt) files up to 10 MB. It reads the first 20,000 characters. Your Format learns from the opening part of each document, so put your most typical writing near the start. HeyNews stores the file privately and never publishes it. It deletes the upload after 30 days and keeps the text it read for your Format.
If a document can't be used, the form says why, so you can fix it:
A password-protected file needs its password removed first.
A scanned PDF is an image of each page, so it has no text to read. Paste the words instead, or upload a copy where you can select the text.
An older Word file (.doc), or a file saved under the wrong extension, needs saving again as one of the supported types.
If you start the form before signing up, your documents stay with your answers when you create your account. If you have more than one Publication, a document you attached in one Publication can't be used in another. The summary marks it Not available here, so attach it again there.
If you saved samples before these labels existed, the summary marks them Needs a label. Choose Label samples and mark each one. Until you do, HeyNews uses them only as a general guide to style, never as your own writing.
The form uses your App Language. You choose the newsletter's writing language separately, so a Turkish interface can still produce an English newsletter. HeyNews saves your answers before moving to the next page, and you can return to finish later. The last page opens a summary where you can edit any section before payment.
If you start before signing in
When public setup is available, you can answer the questions before creating your account. Once you submit your email, your answers stay saved while you finish signing in. Use the link in your account email to continue setup. If account creation fails, check your email address and use the account button to try again. If HeyNews cannot confirm completion, reload before changing your answers.
If another tab changed your answers, HeyNews opens the latest version for you to review. If that tab already finished them, continue with account setup; you can edit the saved answers after signing in.
If you already publish an email newsletter, choose I already have a newsletter above the form. HeyNews will take you to the connection flow, where it can learn from your archive through Voice Training.
Pay the Format Fee
Each Format Run costs $19 and includes one Format Re-run. If you are new to HeyNews, choose a monthly plan and review the 14-day trial terms during checkout. The checkout saves your card, but the trial does not start yet. After payment, HeyNews opens your Newsletter Format as it is being prepared. If confirmation takes longer, use Check payment again before paying again.
If you already have a paid subscription, you pay the same Format Fee without choosing another plan or starting another trial. The same applies when the HeyNews team has granted you a paid plan. A new account still needs to choose a plan and accept the trial terms.
Review your Newsletter Format
HeyNews researches your subject, checks potential Sources, and prepares a Newsletter Format. It includes the planned Sections, Style Rules, visual styling, and notes explaining important choices. HeyNews doesn't suggest Reusable Links. You add the ones you want yourself.
Preparation statuses and step names follow your App Language. Source titles, Decision Notes and review findings keep their original wording.
Before the review opens, HeyNews gives the Positioning, Editorial Angle, and Section purposes one last wording edit to take out stiff or generic phrasing. HeyNews checks that edit against the original for facts, meaning, voice, language, links and Section order. If the checks refuse it, HeyNews keeps the original wording, which already passed its checks.
The review lists the Sections, headlines, validated Sources, and Style Rules HeyNews prepared. Anything that still needs your attention appears as a flagged check.
Press Tab to move between editable fields. The highlighted field shows where you are working.
The Format Specification card at the top describes the newsletter itself:
Positioning says who the newsletter is for and what it promises them.
Editorial Angle is the point of view your newsletter takes on its topics, such as practical advice for owners or a skeptical look at industry claims.
Cadence is how often you plan to publish.
Promotional Slots is how many places each issue sets aside to promote something of your own, like a product or an event. The card shows how many this Newsletter Format allows. Use 0 to keep every issue fully editorial.
Sections lists the parts of each issue in the order they appear, top to bottom. Under each one, Example Headlines shows recent stories HeyNews fetched from your validated Sources. You can open an example, but you can't edit it. A Section with no example says No verified example yet. HeyNews won't make one up, and you can still approve the Newsletter Format.
Publication Styling sets the colors and fonts of your Newsletter Format. Its fields match the basic style settings in beehiiv:
Seven colors: Outside Background, Post Background, Text On Background, Primary, Text On Primary, Secondary, and Links. Pick a color, or type its six-digit hex value, such as
#1A2B3C.Heading and Paragraph Text, each with a Font Family and a Font Weight. Choose the font family from the list and the weight from Regular or Bold.
A new Newsletter Format starts with a white page, dark gray text, Instrument Sans Bold headings, and Inter Regular paragraph text. Your brand book or website can change those starting choices.
If a color would make text hard to read, like dark text on a dark Primary color, HeyNews changes it when it prepares your Newsletter Format or when you save. Colors Adjusted for Readability names each changed color with its old and new value. The fields and the preview both show the new color.
The preview shows your Publication Styling inside HeyNews only. A font that isn't installed on your device uses a similar fallback in the preview; your chosen font stays saved. Approving your Newsletter Format doesn't change any settings in beehiiv or another sending platform. To use these colors and fonts in your emails, enter them in your sending platform's style settings.
A Newsletter Format created before this change keeps its colors and fonts. If it uses a font that isn't on the list, that font stays selected until you choose another one.
Review the proposal before you approve it. You can edit the available fields or give feedback. When you save your changes, HeyNews checks the Newsletter Format again. A flagged check you have fixed goes away, and a new one appears if an edit created a problem.
Edit your Sections
Each Section has a title, a Purpose that says what it gives readers, a story count, and a word range. You can change any of them. Use 1 to 15 stories and word counts from 0 to 2,200, with the minimum no higher than the maximum. If a number is outside those limits, the Section explains what to change before you can save. Fields pause while HeyNews saves your changes.
Use the up and down arrows beside a Section to move it. The Demo Issue and your AI Writer follow the order you save.
To add a Section, fill in Add a Section at the end of the list. It needs a title and a purpose. The story count starts at 1 and the word range at 100 to 250 words; change them if you like. A new Section shows No verified example yet, because examples only come from stories HeyNews fetched.
To remove a Section, choose Remove. If some Style Rules apply only to that Section, HeyNews asks what should happen to each one: move it to another Section or delete it. Cancel leaves the Section and its rules alone. HeyNews never turns one of those rules into a rule for all sections on its own.
A Newsletter Format needs at least one Section and can have up to 12. Renaming or moving a Section keeps its Style Rules with it. A Section from a Newsletter Format created before this change may have no purpose; you can add one or leave it empty.
The review chat can add, move, or remove a Section too. If you ask it to remove a Section that has its own Style Rules, tell it whether to move or delete each one. It won't turn them into rules for all sections.
Choose Save Format changes to keep your edits. If your Newsletter Format changed after you opened the page, for example in another browser tab, HeyNews doesn't save over that change. Reload the page to see the latest version, then make your change again.
Edit Style Rules
Style Rules are the writing preferences your AI Writer follows in every issue. They appear as one list, and there's no required number. You can change the wording of any rule, delete any rule (even all of them), or add one under Add a Style Rule. A Newsletter Format can keep up to 50 rules.
A rule applies to all sections unless you pick one Section in Applies To. The list shows your current Section titles, and a rule stays with its Section if you rename or move it.
HeyNews doesn't write rules that name a particular Source, so your rules still make sense when your Sources change. Whatever your rules say, HeyNews still checks that stories come from your Sources and that every link is allowed.
A rule that repeats or contradicts another rule shows up as a flagged check. So does an older rule that points to a Section the Newsletter Format no longer has. That rule keeps the Section name it was saved with until you choose a Section or All sections.
Add your own Reusable Links
Reusable Links are standing links that any issue can use, such as your subscribe page or a social profile. The list starts empty. Choose Add Reusable Link, enter a full web address that starts with http:// or https://, and add link text if you want. Use the pencil next to a link to change it, or the bin to remove it, then save your Format changes. You can add up to 20 links, but very long web addresses fill the space sooner. If you run out, HeyNews asks you to remove a link or shorten its link text.
Approving your Newsletter Format and its Demo Issue keeps your links as you left them. The review chat can't add or remove a link, so make link changes in the Reusable Links card. The Demo Issue only uses a link HeyNews can open while it writes; a link that doesn't open stays on your list. Once you approve the Demo Issue, your AI Writer starts with the same Reusable Links, and you can change them later on its page.
A Newsletter Format created before this change may already list links that HeyNews added. They stay until you remove them.
If any checks are still flagged when you approve, HeyNews asks you to confirm that you have read them. Select the acknowledgement checkbox before choosing Approve Newsletter Format. You do not need to resolve every flag to approve. If the checks change while you are reviewing, HeyNews shows the current checks and asks you to review and confirm them again.
If the proposal needs a fresh start, use the included Format Re-run. A Format Re-run replaces the current proposal, including Reusable Links you added, so copy anything you want to keep before you begin.
For eligible new customers using the Format Fee offer, approving the Newsletter Format starts the 14-day trial on the plan selected at checkout. Existing paid customers keep their subscription and do not start another trial.
Review the Demo Issue
After approval, HeyNews creates a Demo Issue from recent, checked Sources and gives it the same final wording edit. The edit keeps every fact, link, heading, and Section as it was. If it would change any of them, HeyNews saves the checked original instead. The Demo Issue is a real Draft in Compose.
Open Demo Issue in Compose appears once the Demo Issue is saved and ready to edit. Until then, the page says it's being prepared. If the button doesn't appear after the Demo Issue is finished, contact support.
Edit the Demo Issue as you would any other Draft, then approve it when the structure and writing feel right.
Your approved Newsletter Format and Demo Issue set up the Publication and AI Writer for future Drafts. Your first Format Fee trial uses the empty Publication created at signup.
Additional newsletter formats need room for another Publication on your plan. If your edits conflict with a measurable Style Rule, HeyNews follows the edit and adjusts the rule so the AI Writer does not receive contradictory instructions.
Connect delivery
The final setup step is Connect your sending platform. Select a ready Sending Connection before creating more Drafts or turning on Draft Automation. For beehiiv, connect draft publishing, choose the destination Publication, and select Use for new provider drafts. A ready Kit connection also meets this setup requirement. Use Create draft in Kit where Kit drafts have been turned on, or copy your finished Issue into Kit yourself. Importing a public archive by itself does not complete delivery setup.
HeyNews creates and saves Drafts. You still review and send them from your publishing platform.
