Back to docsSquarespace Integration
How to Embed Testimonials on Squarespace
Add a ShoutHive testimonial wall or popup to your Squarespace site. The widget uses Shadow DOM for style isolation and works seamlessly with Squarespace's templates.
Squarespace Business plan or higher required. Custom code injection and Code Blocks are not available on the Personal plan. You need a Business, Basic Commerce, or Advanced Commerce plan to add custom scripts.
Embedding the Testimonial Wall
- In your ShoutHive dashboard, go to the Wall page and copy your embed code.
- In the Squarespace editor, navigate to the page where you want the wall.
- Click + to add a new block, then select Code.
- Make sure the display is set to HTML (not Markdown), then paste:
<div data-testimonial-wall
data-org="your-org"
data-theme="light"
data-layout="masonry">
</div>
<script src="https://app.shouthive.com/widget.js"></script>- Click Apply, then Save the page.
Squarespace 7.0 vs 7.1: On 7.0, Code Blocks are found in the content editor. On 7.1, click + in any section, then choose Code from the block menu.
Adding a Social Proof Popup
For site-wide popups, use Squarespace's Code Injection feature. For a single page, use a Code Block instead.
Site-wide (via Code Injection)
- In the ShoutHive dashboard, go to Popups and copy the embed code.
- In Squarespace, go to Settings → Advanced → Code Injection.
- Paste the popup script into the Footer section:
<script
src="https://app.shouthive.com/popup-widget.js"
data-popup-id="your-popup-id"
async
></script>- Click Save. The popup will appear on all pages.
Per-page popups (7.1): In Squarespace 7.1, you can also add code to individual pages via Page Settings → Advanced → Page Header Code Injection.
Customization
Customize the wall by changing data-* attributes:
- data-theme —
light,dark, orauto - data-layout —
masonry,grid,carousel, orcoverflow - data-rows / data-speed — carousel row count and scroll speed
- data-anim-entrance, data-anim-tilt, data-anim-flip — animation toggles
Popup settings are managed from the ShoutHive dashboard — no code changes needed.
Troubleshooting
Do not load the widget via Google Tag Manager. The widget infers its API endpoint from the script tag's
src attribute, which GTM does not preserve. Paste the script directly using Code Injection or a Code Block.Common issues
- Code Block option missing: You need a Business plan or higher. Code Blocks and Code Injection are not available on the Personal plan.
- Widget not rendering in editor: Squarespace doesn't execute scripts in the editor preview. Save and view the published page.
- Code Block showing raw HTML: Make sure you selected HTML mode (not Markdown) when creating the Code Block.
- No testimonials showing: Verify your wall slug and that you have approved testimonials in the dashboard.
Ready to embed your testimonial wall?
Sign up, approve your first testimonials, and get your embed code in minutes.
Get started free