HomeDocumentation

Overview

ShoutHive helps you collect, curate, and showcase real testimonials on your website. Create branded forms, record video testimonials, import reviews from G2, Google, Apple App Store, Google Play Store, Capterra, and Trustpilot, paste social media links, or send email campaigns — then embed a beautiful wall or popup with a single script tag.

Once your wall is live, ShoutHive keeps it growing. It monitors Reddit, X (Twitter), Threads, and TikTok for new brand mentions, scores them with AI, and surfaces the best ones in your review queue — automatically.

How it works

Collect testimonialsReview & approveEmbed on your siteAuto-discover new onesWall grows over time

Collection

ShoutHive gives you multiple ways to collect testimonials — branded forms, video recording, email campaigns, paste-a-link, review platform imports, and CSV upload.

Collection Forms

Create branded public forms to collect testimonials directly from your customers. Each form gets a unique URL you can share via email, social media, or embed on your site.

Custom fields

Configure which fields to show — name, email, job title, company, and star ratings. Toggle each on or off per form.

Auto-tagging

Define tag sets for each form. Submissions are automatically tagged so you can organize and filter them later.

Permission granted

Form submissions automatically have permission set to 'granted' — no additional consent flow needed.

Review queue

Every submission lands in your pending queue as a 'Form Submission' with a purple accent. Nothing is auto-published.

Share your form URL after a customer completes a purchase, in a follow-up email, or as a link in your product's UI. The public form page renders without any dashboard chrome for a clean customer-facing experience.

Video Collection

Collect video testimonials from your customers. They can record directly from their webcam or upload an existing video file — no app install required.

Webcam recording

Customers record up to 2 minutes of video directly in their browser. A 3-second countdown and live timer keep things smooth.

File upload

Supports MP4, WebM, MOV, and MKV files up to 100MB. Resumable uploads handle flaky connections.

Video request pages

Create branded pages with your logo, accent color, and custom prompt. Each page gets a shareable public URL.

Video campaigns

Send email campaigns linking to your video request page. Track which recipients recorded a testimonial.

How it works

  1. Create a video request page with your branding and a prompt (e.g., "What do you love about our product?").
  2. Share the page URL directly or send it via an email campaign.
  3. Customers record or upload a video, enter their name and email, and submit.
  4. The video appears in your review queue. Approve it and it shows as a thumbnail with click-to-play on your wall and popups.

Page customization

  • Branding — add your logo URL and choose an accent color to match your brand
  • Content — set a custom title, description, and prompt to guide respondents
  • Thank-you message — customize the title and message shown after submission
  • Enable / disable — temporarily close submissions without deleting the page

Recording details

  • Max duration — 2 minutes per recording with a live timer on screen
  • Countdown — 3-second countdown before recording starts
  • File upload — accepts MP4, WebM, and MOV files up to 100MB
  • Resumable uploads — uses the TUS protocol so uploads survive flaky connections

On your wall

Approved videos display as a thumbnail preview. Visitors click to play the video inline via Cloudflare Stream — no external redirect. Only fully processed videos appear on the wall.

Each video page tracks view count and submission count so you can see which pages are performing best.
Video testimonials work on all modern browsers including mobile. iOS Safari automatically uses MP4 format for best compatibility.

Email Campaigns

Send testimonial request emails to your customers with a link to a collection form or video request page. Track who received the email and who submitted a testimonial.

How it works

  1. Create a campaign and link it to a collection form or video request page.
  2. Add recipients — paste emails or import a list.
  3. Send the campaign. Each recipient gets a personalized email with a CTA linking to your form.
  4. Track delivery status and see which recipients submitted a testimonial.
Emails are sent via Resend for high deliverability. Each recipient's status is tracked individually — sent, delivered, or failed.

Review Platform Import

Import existing reviews from major review platforms directly into your testimonial queue. Star ratings are preserved and displayed on your wall and popups.

Supported platforms

G2

Import B2B software reviews. Enter your G2 product URL to fetch reviews with ratings and author details.

Google Reviews

Import Google Maps business reviews. Search for your business by name — ShoutHive finds it automatically.

Apple App Store

Import iOS app reviews from Apple's public feed. Enter your App Store URL to fetch reviews with star ratings.

Google Play Store

Import Android app reviews. Enter your Play Store URL to fetch reviews with ratings and dates.

Capterra

Import B2B software reviews from Capterra. Enter your Capterra product URL to fetch reviews with ratings, pros/cons, and reviewer details.

Trustpilot

Import Trustpilot reviews. Enter your Trustpilot business URL to fetch reviews with ratings and author info.

How it works

  1. Pick a platform from the import modal.
  2. Enter your product URL (or search by business name for Google Reviews).
  3. Preview the fetched reviews. Already-imported reviews are flagged to prevent duplicates.
  4. Select the reviews you want and import them. They land in your review queue as pending.
Fetching reviews may take up to a minute depending on the platform and number of reviews. A loading indicator is shown while ShoutHive retrieves them.

After importing

  • Duplicate detection — already-imported reviews are automatically flagged during preview so you don't import them twice.
  • AI analysis — imported reviews receive automatic sentiment analysis and relevance scoring. Star ratings are mapped to sentiment: 4-5 stars become praise, 3 stars are neutral, and 1-2 stars are negative.
  • Review queue — all imported reviews land as "pending" in your review queue. Approve them before they appear on your wall.
  • Permission status — set to "not needed" since reviews are already public on their original platform.

CSV Import

Import testimonials from any source by uploading a CSV file. This is useful for migrating from another testimonial tool or importing reviews from platforms ShoutHive doesn't connect to directly.

Drag-and-drop upload

Drop a CSV file (up to 5MB) into the import modal. ShoutHive parses it instantly.

Auto column detection

Common column names like 'name', 'author', 'content', 'review', 'rating', and 'date' are automatically mapped.

Column mapping

Adjust the detected mapping with dropdown selectors. Map columns to author name, content, star rating, date, and source URL.

Preview before import

See a preview of the first few rows with your column mapping applied before importing everything.

AI analysis is optional for CSV imports — enable it during import to get sentiment scoring and relevance analysis. Platform imports run AI analysis automatically.
Duplicates are detected by matching review content, so re-importing the same CSV won't create duplicates. Export reviews from another tool as CSV, then import them into ShoutHive to consolidate all your testimonials in one place.

Widgets & Embedding

ShoutHive provides three types of embeddable widgets. Install via npm for React, Next.js, and Vue projects, or use a single script tag for any website. Each widget is fully isolated and won't conflict with your existing styles.

Testimonial Wall

The testimonial wall displays your approved testimonials in a beautiful, configurable layout. It's lightweight (under 15KB), loads fast, and works on any website — install the @shouthive/widget npm package or paste a script tag.

Embed code

<!-- Add this to your website -->
<div data-testimonial-wall
     data-org="your-org"
     data-theme="light"
     data-layout="carousel">
</div>
<script src="https://app.shouthive.com/widget.js"></script>

Layout options

Masonry

Pinterest-style staggered grid. Cards fill available space with varied heights. Best for mixed-length testimonials.

Grid

Uniform card heights in a clean grid. Best for a structured, consistent look.

Carousel

Auto-scrolling horizontal marquee with configurable speed and row count. Great for above-the-fold social proof.

Coverflow

3D perspective carousel with a focused center card. Eye-catching for hero sections.

Customization

  • Themes — light, dark, or auto (follows system preference)
  • Accent color — custom hex color for highlights
  • Card style — default, minimal, or bordered
  • Animations — fade-in on scroll, hover effects
  • Max columns — control grid density (1–5 columns)
  • Carousel speed — adjust scroll speed for marquee layouts
The widget is fully isolated from your site's CSS — your styles won't affect the wall's appearance, and vice versa.

Social Proof Popups

Social proof popups show individual testimonials as notification-style messages that appear on your pages. They're lightweight (under 8KB) and fully configurable.

Embed code

<script
  src="https://app.shouthive.com/popup-widget.js"
  data-popup-id="your-popup-id"
  async
></script>

Trigger types

Page load

Show the popup after a configurable delay when the page loads. Good for immediate social proof.

Scroll depth

Trigger when the user scrolls past a percentage of the page (e.g., 50%). Useful for pricing or CTA sections.

Exit intent

Detect when the cursor moves toward the browser's close button. Catches users about to leave.

Time delay

Show after a fixed number of seconds on the page. Simple and predictable.

Configuration

  • Position — bottom-left, bottom-right, top-left, or top-right
  • Animation — slide, fade, or bounce entrance
  • Display duration — how long the popup stays visible
  • Delay between popups — minimum gap between consecutive popups
  • Max per session — limit how many popups a visitor sees per visit
  • Testimonial selection — filter by platform, tag, or link a collection to show themed testimonials

Collection-powered popups

Link any popup to a collection to show categorized testimonials. For example, show pricing-related praise on your pricing page or support testimonials on your help center. The popup pulls testimonials directly from the collection — curate once in your collection, display everywhere via popups.

Built-in analytics

Each popup automatically tracks impressions, clicks, and dismissals with zero impact on your page performance. View popup performance from the dashboard to see what's working.

Smart Collections

Collections let you group testimonials for specific pages or audiences. Each collection gets its own public page and can be embedded independently.

Collection types

Auto-filtered

Define rules (by tag, platform, or sentiment) and testimonials are automatically included as they're approved.

Manual (curated)

Hand-pick specific testimonials for precise control. Drag to reorder for your preferred display sequence.

Use cases

  • Different collections for different pages — pricing page testimonials vs feature page testimonials
  • Platform-specific walls — show only Reddit testimonials on a community page
  • Tag-based grouping — "Enterprise" testimonials for your enterprise landing page
  • Seasonal or campaign-specific collections that you can swap in and out

Popup integration

Collections can power social proof popups. Link a collection to a popup and it will show only testimonials from that collection — perfect for page-specific social proof like pricing praise on your pricing page or support feedback on your help center.

Each collection has its own public URL and can power popups. Share the link directly, embed it using the wall widget, or link it to a popup for targeted social proof.

Platform Guides

Step-by-step instructions for embedding ShoutHive widgets on popular website builders. Each guide covers the testimonial wall, social proof popups, customization options, and platform-specific troubleshooting.

Core Features

ShoutHive handles the full testimonial lifecycle — from collecting and curating testimonials to auto-discovering new ones over time.

Review Queue

Every testimonial goes through the review queue before appearing publicly. Nothing is auto-approved — you have full control over what gets displayed.

Status lifecycle

PendingApprovedRejectedArchived

Rejected and archived items can be restored to pending at any time.

Actions

  • Approve — adds the testimonial to your public wall
  • Reject — removes it from the queue
  • Edit — modify the display quote and tags before approving
  • Bulk actions — approve or reject multiple items at once
  • Reorder — drag to set the display order on your wall

AI-Powered Scoring

ShoutHive uses AI to analyze every mention it finds. Each one gets a relevance score, sentiment label, and an auto-extracted quotable snippet — so you spend time reviewing, not reading.

What you get for each mention

  • Relevance score — how closely the mention relates to your brand, from low (noise) to high (premium testimonial)
  • Sentiment — whether the mention is positive (praise), neutral, or negative
  • Extracted quote — a 1–2 sentence quotable snippet, ready to display
  • Auto-tags — topical tags generated automatically so you can filter and organize

Smart filtering

Before anything reaches your queue, ShoutHive automatically filters out bots, spam, duplicate posts, and low-engagement content — so you only see mentions that matter.

The AI understands your brand context — your name, description, keywords, and industry — so it can accurately judge what's relevant to you specifically.

Auto-Discovery

ShoutHive continuously monitors social media for your brand keywords. Set your schedule, and new testimonials show up in your queue automatically — no manual searching required.

Flexible scheduling

Run discovery hourly, daily, or weekly. Configure the interval from your settings dashboard.

Never miss a mention

ShoutHive tracks where it left off between runs so no posts fall through the cracks. Supports backfill to catch older mentions on first setup.

Smart error handling

If something goes wrong, ShoutHive pauses discovery automatically and resumes when the issue is resolved — no wasted resources.

Email notifications

Get notified when new testimonials are discovered. Includes a summary of what was found, with a link to your review queue.

Every discovery run is logged with a summary — how many mentions were found, how many were new, and how many matched as praise. View run history from the dashboard.

Permission Tracking

ShoutHive includes built-in permission tracking to help you manage consent for displaying testimonials publicly. Every testimonial has a permission status that you can track and update.

Permission statuses

Not askedDefault state — no permission request sent yet
RequestedConsent email sent, waiting for response
GrantedAuthor has consented to public display
DeclinedAuthor declined — testimonial should not be shown
Not neededMarked as public content that doesn't require consent

Consent flow

  1. Send a permission request from the review queue — ShoutHive generates a unique consent link and sends an email automatically.
  2. The author visits the consent page, sees their testimonial, and chooses to approve or decline.
  3. The permission status updates automatically. Declined testimonials are flagged in your queue.
For content from public posts (like Reddit threads), you can mark them as "Not needed" to skip the consent flow entirely.

Supported Platforms

ShoutHive monitors four social media platforms for brand mentions and supports importing reviews from six review platforms. You can also collect testimonials via forms, video pages, paste-a-link, and CSV.

Platform Details

Reddit

Searches subreddits and posts for brand mentions. Captures post content, author, subreddit, and engagement (upvotes, comments).

X (Twitter)

Searches tweets and replies. Captures tweet text, author, handle, and engagement (likes, retweets, replies).

Threads

Searches Threads posts for brand mentions. Captures post content, author, and engagement data.

TikTok

Searches TikTok video captions and descriptions. Captures creator info, description, and view counts.

What gets captured

For every mention ShoutHive finds, you get the full post content, author information, platform handle, and engagement metrics. This gives you the context you need to decide which testimonials to approve.

ShoutHive automatically filters out bots, spam, duplicates, and low-engagement posts before they reach your queue — so you only see mentions worth reviewing.

How Search Works

You configure your brand keywords in settings — your product name, common variations, and any terms you want to monitor. ShoutHive searches all connected platforms for these keywords on every discovery run.

Multi-keyword support

Monitor multiple brand names, product names, or variations simultaneously across all platforms.

Cross-platform deduplication

If the same content appears on multiple platforms, ShoutHive detects and deduplicates it so you don't review it twice.

Start with your exact brand name as a keyword, then add common misspellings or abbreviations. You can always adjust keywords later from the settings page.