Platform Guides
Embed Substack on WordPress
Add a Substack subscribe form or feed widget to your WordPress site. Step-by-step guide for Gutenberg, the Classic editor, and widget areas.
WordPress makes it easy to add a Substack subscribe form or feed widget to any page, post, or sidebar. Use a Custom HTML block in Gutenberg, paste the snippet, and publish. Works with any WordPress theme.
What You Can Add to WordPress
- Subscribe Form — an email capture form anywhere on your site with custom branding and a post-subscription redirect
- Feed Widget — your latest Substack posts displayed automatically, keeping your site fresh without manual updates
- Popup Form — a subscribe popup triggered by exit intent, scroll depth, or time on page
Step 1: Create Your Embed in Supascribe
- Sign up at Supascribe — free to start
- Connect your Substack publication
- Choose your embed type: Subscribe Form or Feed Widget
- Customise the colours, fonts, and button text
- Click Publish to generate your embed code
Your snippet:
<div data-supascribe-embed-id="abc123" data-supascribe-subscribe></div>
<script src="https://js.supascribe.com/v1/loader/example.js" async></script>The embed ID and script URL are pre-filled from your dashboard.
Step 2: Add the Embed to WordPress
Option A: Custom HTML Block (Gutenberg — recommended)
The simplest method for embedding on a specific page or post.
- Edit the page or post in WordPress
- Click "+" to add a new block
- Search for "Custom HTML" and select it
- Paste your full embed snippet into the block
- Click Update or Publish
Option B: Sidebar or Footer Widget
To add the embed to your sidebar, footer, or any other widget area:
- Go to Appearance → Widgets
- Add a Custom HTML widget to your chosen area
- Paste your full embed snippet
- Save
Option C: Site-Wide Script Loading
If you're adding embeds across multiple pages, load the script tag once site-wide and use only the embed div in individual blocks.
Using a plugin (recommended): Install Insert Headers and Footers or similar. Paste the script tag into the Footer section. Then use only the div in your Custom HTML blocks — no script tag needed per block.
Via theme files: Go to Appearance → Theme File Editor → footer.php (or your child theme). Add the script tag before </body>. Use only the embed div in your Custom HTML blocks.
Step 3: Test It
After updating your page, open it in an incognito window. The subscribe form should appear in the correct position. Submit a test email to confirm the subscription registers in your Supascribe dashboard.
WordPress-Specific Tips
Classic editor
If you're using the Classic editor, switch to the Text tab (not Visual) when editing your page and paste the snippet directly into the HTML. Alternatively, add a Custom HTML widget in Appearance → Widgets.
Redirect subscribers after sign-up
Set a custom redirect URL in Supascribe before generating your snippet. This sends new subscribers to a thank you page, a specific post, or a lead magnet — improving early engagement and open rates in a way that the basic Substack embed can't.
Placement for conversion
End-of-post placement converts best for engaged readers who've finished an article. An above-the-fold embed on your homepage captures broader intent. Track both placements independently in your Supascribe dashboard to see which performs better for your audience.
Page builders (Elementor, Divi, etc.)
Most page builders include an HTML widget. In Elementor, drag the HTML widget onto your page. In Divi, use the Code module. Paste your full snippet into the code field.
Explore Other Embed Options
Install on any site using plain HTML.
Embed element setup for Carrd pages.
Code block and footer code injection.
Need Help?
- Email: [email protected]
- Twitter: @0xGideon
Frequently Asked Questions
Do I need a plugin to add the embed to WordPress?
No plugin is required. WordPress supports custom HTML natively through the Custom HTML block in Gutenberg and HTML widgets in Appearance → Widgets. The 'Insert Headers and Footers' plugin is optional but useful for loading the script tag site-wide without editing theme files.
Does this work with the Gutenberg block editor and the Classic editor?
Yes. In Gutenberg, use the Custom HTML block. In the Classic editor, paste the snippet in HTML mode (the Text tab) or use a Custom HTML widget.
Can I add the embed to my sidebar or footer?
Yes. Go to Appearance → Widgets, add a Custom HTML widget to your sidebar or footer area, and paste the full embed snippet.
Do subscribers sync automatically to my Substack list?
Yes. Every subscriber captured via Supascribe is added directly to your Substack subscriber list and receives your standard welcome email.
Why isn't my embed showing up on WordPress?
The most common causes: the embed is placed in a Text block instead of a Custom HTML block, or the script tag is missing from the page. Make sure you're using the Custom HTML block, and that either the full snippet is in the block or the script tag is loaded site-wide.
Supascribe
Ready to grow your Substack?
Add a subscribe embed or landing page to any website in minutes. Free to start.
Start for free →