beehiiv website installation
beehiiv Testimonials in the Website Builder
A beehiiv newsletter usually lives on a beehiiv website: the archive, the subscribe page, the about page. On paid beehiiv plans the Advanced Website Builder has an HTML block, and that block is where a StoryProof reader wall goes. beehiiv says interactive widgets run only in Preview and on the live site, never inside the editor, so a blank box while you edit is expected.
- Code for the beehiiv HTML block, wrapped the way beehiiv asks
- Why the editor shows nothing until Preview
- A no code route for free beehiiv plans
beehiiv HTML block
What to paste into beehiiv
Type your StoryProof widget id. Card 1 goes into the Code tab of an HTML block. beehiiv asks for everything inside one container div, so the StoryProof lines are wrapped for you. Card 2 is for writers on the free beehiiv plan, which has no HTML block.
Part 1 · Card 1: HTML block on a paid plan
Website › Builder › + › Advanced blocks › HTML › Configure › Code tab
<div class="storyproof-readers">
<div data-storyproof-widget="YOUR_WIDGET_ID"></div>
<script async src="https://app.storyproof.io/embed.js"></script>
</div>Part 2 · Card 2: Button on a free plan
Website › Builder › your page › Button element
Button element on a beehiiv site without the HTML block
Label: Hear from our readers
URL: [your StoryProof Wall of Love link]Click Save in the code editor, then open Preview from the builder. The widget should appear there, not on the editing canvas. Publish and load the live page once on a phone.
The code is assembled in your browser from the id you type. Nothing is stored.
The problem, solved
Where reader praise goes wrong on beehiiv
Most of these come from how beehiiv’s HTML block behaves, not from the widget.
- Problem 1
The HTML block looks empty in the builder
beehiiv states that interactive elements do not execute inside the editor, only in Preview and Live mode, so writers assume the paste failed and delete it.
How StoryProof solves it
The StoryProof embed is a div plus an async script. Leave it in place and judge it from Preview, where the script is allowed to run.
- Problem 2
My pasted code broke the page layout
beehiiv rejects full document tags such as html, head and body, and warns that global CSS resets can break the page.
How StoryProof solves it
Paste only the two StoryProof lines inside a single wrapper div, as Card 1 does. They carry no document tags and no global styles.
- Problem 3
I am on beehiiv’s free plan
beehiiv lists the HTML block as a paid plan feature, so a free site has nowhere to put code.
How StoryProof solves it
Every StoryProof plan includes a hosted Wall of Love with its own link. Point a beehiiv Button element at it and readers see the full set one click away.
- Problem 4
Subscribers praise us only in reply emails
Kind replies sit in an inbox and nobody signed off on publishing them.
How StoryProof solves it
Share your StoryProof collection link in an issue so readers can record a video, leave an audio note or write a few lines, and approve each one before it can appear.
- Problem 5
Sponsors and readers need different quotes
A subscribe page wants reader voices, while an advertise page wants proof from past sponsors.
How StoryProof solves it
Tag testimonials by audience and pick which approved ones each widget shows, then give each beehiiv page its own HTML block and widget id.
In StoryProof
Add the widget to a beehiiv page
Step 1 of 5
Open the page in the builder
In beehiiv, go to Website, then Builder, and open the page and section where reader praise belongs, such as your subscribe or about page.
Step 2 of 5
Drop in an HTML block
Click the + icon in the left panel, look under Advanced blocks, choose HTML and drag it onto the canvas.
Step 3 of 5
Paste the wrapped code
With the block selected, click Configure, open the Code tab and paste Card 1. Use the Preview tab inside the editor only to check the markup, then click Save.
Step 4 of 5
Check it in Preview
Open the builder’s Preview. This is the first place the script runs. If the widget shows there, publish the site.
Step 5 of 5
Confirm on the live site
Load the published page on a phone and a laptop and scroll through the widget to see it fits the section width.
Which beehiiv route fits your publication
Before you start
Limits on beehiiv
Paid beehiiv plans only
beehiiv’s help names the HTML block as a paid plan feature. On a free plan the widget cannot be embedded and the Wall of Love link is the route.
Nothing runs in the editor
beehiiv says interactive elements execute only in Preview and Live. You cannot judge the widget from the editing canvas.
Scripts are not named in beehiiv’s list
beehiiv’s article lists interactive widgets as supported and asks you to test them in Preview, but it does not mention script tags by name. Preview is the real test.
Website pages, not issues
This guide covers the beehiiv website builder. Newsletter posts and emails use a different editor and are not covered here.
beehiiv help as of 2026-11-14
The menu names, plan rule and block rules come from beehiiv’s support article as read on 2026-11-14. They have not yet been followed on a live beehiiv site.
FAQ
Questions people ask
Short answers to what usually comes up next.
Does the legacy beehiiv website builder work the same way?
beehiiv’s article is written for the Advanced Website Builder and notes that iframe behaviour differs from the legacy builder. If you are still on the legacy builder, test in Preview before you publish.
Can I put the widget in the same HTML block as a beehiiv subscribe form embed?
beehiiv says embedded subscribe forms cannot be used in HTML blocks and asks you to use its native subscribe form block. Keep the form native and the StoryProof widget in its own HTML block.
Why does beehiiv want one container div?
Its help asks you to wrap all content and styles in one container so nothing leaks into the rest of the page. Card 1 already does this.
Can readers leave a voice note instead of writing?
Yes. The StoryProof collection link takes video, audio notes or text, and audio notes play in the widget and on the Wall of Love.
Is there a character limit in the HTML block?
beehiiv mentions a 50,000 character limit for the editor’s content. The two StoryProof lines are far below it.
Still have a question? Ask the StoryProof team or book a demo.
Put reader voices on your beehiiv site
Collect testimonials from subscribers, approve the ones you like, and drop one widget into a beehiiv HTML block.
Sources
- Using HTML in the Website Builder, beehiiv Support. Checked 2026-11-14.
Last updated 2026-11-14.