← Back to Blog

How to Add Links and Buttons to Your Substack Posts

Formatting

Links are the connective tissue of a newsletter. They point readers to sources, related posts, products, tools, and actions. Buttons are the louder cousin — visual CTAs that drive specific behaviors like subscribing, upgrading, or visiting a page.

Substack gives you both, but using them effectively requires more thought than just pasting URLs. This guide covers the mechanics, best practices, and strategy behind links and buttons in Substack.

The Basics

To add a link in Substack’s editor:

  1. Select the text you want to turn into a link
  2. Press Cmd/Ctrl + K
  3. Paste the URL
  4. Press Enter

The selected text becomes the anchor text — the clickable part that readers see.

Anchor Text Best Practices

The text you link matters as much as the URL itself.

Good anchor text is descriptive and tells readers what they’ll find:

  • “Read the full earnings report” — clear destination
  • “a recent study on email open rates” — contextual and informative
  • “the official Substack documentation” — specific and trustworthy

Bad anchor text is vague or generic:

  • “click here” — tells readers nothing about the destination
  • “this link” — equally unhelpful
  • A bare URL like “https://example.com/long-path” — ugly and uninformative

Where you place links within your text affects click-through rates:

  • Early in the post: links in the first few paragraphs get more clicks (readers haven’t started skimming yet)
  • Within relevant context: link to a source right where you discuss it, not three paragraphs later
  • End of sections: a relevant link at the end of a section serves as a natural “go deeper” option
  • Above the email fold: email clients show a preview of the first few hundred pixels — links placed here are most visible

How Many Links Per Post

There’s no hard rule, but guidelines exist:

  • 5-10 links is typical for a standard 1,500-word post
  • Under 5 may feel unsupported (where are your sources?)
  • Over 15 starts to feel like a link dump and can trigger spam filters

The key is relevance. Every link should earn its place by adding value for the reader.

Button Blocks

Substack’s button block is a styled call-to-action that stands out visually from regular text.

Adding a Button

  1. Place your cursor between paragraphs
  2. Click the + icon that appears
  3. Select “Button”
  4. Enter the button text and destination URL

Button Styling

Substack buttons have a fixed design — you can’t customize colors, size, or border radius. They render as a full-width (or near-full-width) button with your text centered.

The visual prominence of buttons makes them ideal for important actions, but their fixed styling means you need to be strategic about where you use them.

When to Use Buttons

Subscribe CTAs: Buttons are effective for encouraging free readers to subscribe, especially mid-post where engagement is high.

Paid upgrade prompts: When promoting paid content, a button feels more intentional than a text link.

External resources: Linking to a tool, product, or important document that you want readers to act on.

Share prompts: Encouraging readers to share the post on social media or forward the email.

When Not to Use Buttons

  • Source citations: inline text links are better for referencing sources
  • Multiple options in a row: three buttons stacked looks cluttered
  • Every post: if every post has five buttons, readers start ignoring them
  • Trivial links: a button that links to a tangentially related article diminishes the format’s impact

Button Frequency

One to two buttons per post is the sweet spot. One for your primary CTA (subscribe, upgrade, check out a tool) and optionally one for a secondary action (share, read related post).

Beyond regular hyperlinks and buttons, Substack offers several specialized link features:

Subscribe Buttons

Substack has a dedicated “Subscribe” button that triggers the subscription modal. This is different from a regular button — it’s tied to Substack’s authentication system and is the primary conversion mechanism.

Share Buttons

The share widget lets readers share your post on Twitter/X, Facebook, email, or copy a direct link. Substack provides a share block you can insert between paragraphs.

Substack’s referral program generates unique links for each subscriber. When they share their link and someone subscribes through it, both parties can receive rewards you define.

Post Links

You can link to your own previous posts using Substack’s internal linking. When you paste a Substack post URL, the editor offers to convert it into a preview card with the post title, subtitle, and thumbnail.

Internal Linking

Link to your own previous posts whenever relevant. This:

  • Increases time on site
  • Exposes new subscribers to your archive
  • Creates a web of interconnected content that benefits SEO on Substack’s web version
  • Demonstrates expertise and consistency

External Linking

Generous external linking builds trust. When you link to quality sources, readers see you as a curator of good information, not just a self-promoter.

However, be thoughtful about linking to competitors or paywalled content your readers can’t access.

Tracking Awareness

Substack doesn’t offer built-in link tracking (no UTM parameter analytics). If you need click tracking:

  • Use UTM parameters on external links and track in Google Analytics
  • Use a link shortener like Bitly that provides click statistics
  • Monitor referral traffic in the destination site’s analytics

For writers who draft in markdown, links use the standard syntax:

[anchor text](https://example.com)

When converting markdown to Substack-ready rich text, links transfer cleanly — the anchor text and URL are preserved. Tools like DownStack handle this conversion automatically as part of the markdown-to-Substack workflow.

Buttons don’t exist in standard markdown, so they’ll need to be added after pasting into Substack’s editor. This is one of the few post-paste formatting steps in a markdown workflow.

Email Rendering Considerations

In email, links typically appear in a different color (blue or your publication’s accent color) and may be underlined. This varies by email client.

Button Rendering

Substack’s buttons render as styled HTML in email. They work across most email clients, but some older Outlook versions may render them as plain text links. This is a known limitation of HTML email rendering.

When you paste a URL as a preview card in Substack’s editor, the card (with thumbnail and title) renders on the web version. In email, it typically renders as a styled link with the title and description.

Mobile Tapping

On mobile, links and buttons need sufficient tap targets. Substack handles this for buttons (they’re full-width), but dense paragraphs with many closely spaced links can be frustrating on mobile. Space out your links and keep anchor text reasonably long (at least a few words) for easier tapping.

Key Takeaways

  • Use Cmd/Ctrl + K to add links; write descriptive anchor text instead of “click here”
  • Aim for 5-10 links per 1,500-word post — every link should add value
  • Buttons are for high-priority CTAs: subscribe, upgrade, or key actions
  • Limit to 1-2 buttons per post to maintain their visual impact
  • Internal linking to your own archive increases engagement and demonstrates expertise
  • External linking builds trust — be generous with quality sources
  • Buttons need to be added in Substack’s editor (they’re not in markdown syntax)
  • Test email rendering for both links and buttons before publishing