The article editor

Everything in the WriteStack article editor (title and subtitle, toolbar, the / menu, Substack buttons, freewall and paywall, audience-specific sections, footnotes, post embeds, mentions), how autosave and version history work, keyboard shortcuts, and what changes when the article goes to Substack.

The article editor works like Substack's: the same blocks, buttons and walls, so what you write here looks the same on Substack after you push. It saves on its own about 3 seconds after you stop typing.

Open it by clicking an article on the Articles page, or with New article.

The top bar

ItemWhat it does
Back arrowGoes back to the Articles page.
Save statusSaving..., Saved, or Couldn't save · Retry.
Substack statusWhether Substack has your latest version. See Push an article to Substack.
HistoryVersion history.
Open in SubstackOpens the Substack draft, once the article is pushed.
Word countWords in the body. The title and subtitle don't count.
CommentsComments on the draft. See Share a draft and get comments.
ShareA private link to the draft.
CopyCopies the whole article, with formatting, to paste anywhere.
Push to SubstackSends it to Substack as a draft.

At the bottom right, Settings opens Post settings and Ask Quill opens Quill.

Title and subtitle

FieldLimit
Title200 characters
Subtitle200 words

Both can be left empty. An article with no title shows as "Untitled article". To push it to Substack, give it a title, or an SEO title or URL slug in Post settings.

A counter shows while you type in a field. Press Enter to move to the next field. Both fields are one line: line breaks you paste become spaces.

The toolbar

ButtonWhat it does
Undo, RedoUndo or redo the last change.
StyleNormal text or Heading 1 to Heading 6.
Bold, Italic, Strikethrough, Inline codeFormat the selected text.
Text color, Highlight color60 colors. None removes the color.
LinkAdds a link to the selected text.
Image, Audio, VideoSee Images, video and audio.
QuoteBlockquote, Pullquote, Callout block or Collapsible text.
Bullet list, Numbered listStart a list.
Text alignmentAlign left, Align center, Align right, Justify. Works on paragraphs and headings.
ButtonInsert a Substack button. See Buttons.
TemplateInsert a saved template. See Templates.
MoreAudience-specific content, Code block, Divider, Footnote, Freewall, Paywall, Poetry, Superscript, Subscript.

The editor has no tables and no underline.

Selected text

Select text to get a small menu above it: Ask Quill, Comment, Bold, Italic, Strikethrough, Inline code, Link, Highlight, Heading 1 to Heading 3, Quote, Bulleted list and Numbered list.

The / menu

Type / to insert any block. Keep typing to filter, use the arrow keys to pick, and press Enter.

SectionItems
TextHeadings 1 to 3, lists, Quote, Pullquote, Callout, Collapsible text, Code block, Poetry
BlocksImage, Video, Audio, Divider, Footnote
ButtonsEvery Substack button, and Custom button
AudienceFreewall, Paywall, Free readers only, Paid readers only, Custom audience
TemplatesYour saved templates

Type a section name, like /buttons, to see the whole section.

Buttons

ButtonWhat readers see
SubscribeA Subscribe now button
Subscribe w/ captionA line of text, an email box and a Subscribe button
Share postA Share button
Share post w/ captionA line of text and a Share button
Leave a commentA button that opens the comments
Custom…A button with your own text and link

For Custom…, fill in Button text and Link (it must start with http:// or https://), then click Insert button.

To change a button after you insert it, delete it and insert a new one.

Captions on Subscribe and Share blocks

Click the caption on a w/ caption block to edit it. It's one line.

To change the text every new block starts with:

  1. Hover the block and click the gear.
  2. Write your text under Default text (up to 1,000 characters).
  3. Click Save.

The default is per newsletter. Blocks already in your articles don't change. Reset goes back to the standard text.

Freewall and paywall

A wall hides everything below it from some readers.

WallWho sees what's below it
FreewallSubscribers, free or paid
PaywallPaid subscribers

Insert one from More or the / menu. A post has one wall: inserting a new one removes the old one. To remove it, select the wall and click Remove wall under More.

Inserting a wall also sets the post's Audience in Post settings: Freewall sets Subscribers only, Paywall sets Paid only.

Audience-specific sections

An audience-specific section shows its content only to the readers you pick. Everyone else sees nothing, or a second part you write for them.

  1. Click More → Audience-specific content and pick Free readers, Paid readers or Custom.
  2. Use the Audience picker on the section to choose who sees it:
OptionWho it is
Not subscribedAnyone who isn't subscribed
Free subscribersAnyone with a free subscription
Paid subscribersAnyone with a paid subscription
Founding subscribersOnly founding subscribers
  1. Write the content inside the section.
  2. Optional: click Everyone else + to add what everyone else sees.

Free readers picks Not subscribed and Free. Paid readers picks Paid and Founding, and starts the part for everyone else with an upgrade box. Remove that part and other readers see nothing.

Audiences outside the post's own audience are greyed out. The section warns you when it won't show to anyone ("Won't render: no audiences selected") or when it covers the whole post audience.

Other blocks

BlockHow it works
Collapsible textHidden until readers click to open it. Set the labels readers click: Collapsed (default "Show more") and Expanded (default "Show less"), up to 120 characters each. It's always open in the editor.
FootnoteAdds a number where your cursor is and a note at the end of the post. Substack numbers them in order.
PoetryKeeps every line break. Enter starts a new line. No formatting inside it.
Code blockMonospace text.
DividerA horizontal line.
Superscript, SubscriptRaised or lowered text, like x² or x₂. You can't use both on the same text.

Embed a Substack post

Paste a link to a Substack post (/p/ in the address) on an empty line. It turns into a card with the post's title, byline, date and cover. Pasted in the middle of a sentence, it stays a normal link.

Hover the card and open its menu to pick Small display, Medium display or Large display (the default), Edit caption, Convert to link or Remove. Small cards have no caption.

Mentions

Type @ and a name to mention someone on Substack. Pick them from the list. Hover a mention to see their profile. Mentions need the browser extension to search.

Typed web addresses become links on their own. To link text, select it and click the link button (or Cmd+Shift+K). Enter the URL and click Apply. https:// is added if you leave it out. Remove takes a link off.

Blocks from Substack

When you import a draft that has blocks WriteStack can't edit, like a poll, a recipe, a YouTube or Tweet embed, or an embedded Note, they show as labelled boxes such as "Poll (edit on Substack)". They go back to Substack unchanged when you push.

Autosave

  • The article saves about 3 seconds after you stop typing. Cmd+S (Ctrl+S on Windows) saves right away.
  • A failed save is tried 3 times. If it still fails, click Retry.
  • If the article was changed in another tab, by the Coach or by an AI agent while you had edits, you see "This article changed elsewhere". Reload takes the other version. Keep mine keeps yours.
  • Leaving with unsaved changes asks "Changes are not saved. Leave anyway?"

Version history

Click History to see earlier versions of the title, subtitle and body.

  • Versions are saved as you edit. Edits within 10 minutes are grouped into one version.
  • Labels show where a version came from: Edited with Quill, Edited by AI (an agent over MCP), or Restored.
  • Click a version to preview it, then Restore this version. Your current version stays in the history, so you can go back.
  • Up to 50 versions are kept per article. History covers the title, subtitle and body, not Post settings.

Keyboard shortcuts

On Windows, use Ctrl instead of Cmd.

ShortcutDoes
Cmd+SSave now
Cmd+JAsk Quill
Cmd+Shift+KAdd a link
Cmd+B, Cmd+IBold, italic
Cmd+Shift+XStrikethrough
Cmd+EInline code
Cmd+Shift+HHighlight
Cmd+Option+1 to 6Heading 1 to 6 (Ctrl+Alt on Windows)
Cmd+Shift+BQuote
Cmd+Shift+8, Cmd+Shift+7Bullet list, numbered list
Cmd+Z, Cmd+Shift+ZUndo, redo

What changes on Substack

Everything in the editor has a Substack match, so a push keeps your formatting, colors, alignment, blocks, buttons, walls and audience sections. A few small things change:

  • A numbered list always starts at 1.
  • Code blocks have no language.
  • Images keep no caption.

If it doesn't work

What you seeFix
Couldn't save · RetryClick Retry. If it keeps failing, check your connection and copy your text somewhere safe.
"This article changed elsewhere"Pick Reload or Keep mine.
"Won't render: no audiences selected"Pick at least one audience for the section.
"Not in this post's audience"The post's Audience doesn't include those readers. Change it in Post settings.

On this page