📖

Documentation

Everything you need to get started with Beautimonial

🔍

Browse Documentation

1. Getting Started

1.1 What is Beautimonial?

Beautimonial is a smart testimonial widget for brands. Install it on your website and your customers can submit reviews and beautify them with one click.

The result: professional, polished testimonials that actually convert visitors into customers.

How It Works in 3 Steps

Install Widget

Add one line of code to your website. Takes less than 60 seconds.

Customer Leaves Review

A floating button appears on your site. Customers click, type their feedback, and hit "Beautify." If their answer is thin, we ask one or two quick follow-up questions so the details come from them.

Testimonial Goes Live

Their words come back polished — same facts, better flow. Your customer approves the final version, you approve it from your dashboard, and it appears on your website.

1.2 Quick Start Guide

When you sign up, Beautimonial drops you into a short guided setup — three steps from account to live widget. You can skip any step and finish it later from your dashboard.

Tell us about your business

On the free plan (no card, no time limit), enter your business name and your website domain. This creates your first space and locks the widget to your domain for security.

Get & install your widget code

The wizard shows your unique one-line snippet with copy-paste tabs for Shopify, WordPress, and custom HTML — paste it where the tab tells you (just before the closing </head> tag) and save.

<script src="https://beautimonial.com/widget.js?token=YOUR_TOKEN"></script>

Verify your installation

Click Verify and Beautimonial checks that your widget is live on your site. When it loads, you get a confetti celebration and land in your dashboard, ready to collect.

✅That's it! You're ready to collect beautiful testimonials. 🎉

💡No website, or don't want to touch code? Skip the install step and share your hosted collect page instead — see Hosted Collect Page.

2. Installation Guides

2.1 Any Website (Universal)

Works on any platform that allows custom HTML/JavaScript.

<script src="https://beautimonial.com/widget.js?token=YOUR_TOKEN"></script>

Where to paste: Just before the closing </body> tag in your HTML file.

🛍️Shopify

Online Store → Themes → Edit Code

Find theme.liquid file (or layout/theme.liquid)

Paste your Beautimonial code just before </body> tag

Click Save

Visit your store to test ✅

💡Changes apply to all pages in your Shopify store.

📝WordPress

Option A (Recommended): Plugin

Install the plugin "Insert Headers and Footers"
Go to Settings → Insert Headers & Footers
Paste code in the "Footer" section
Save

Option B: Theme Editor

Appearance → Theme Editor → find footer.php or header.php → paste before </body> → Update File

Option C: Elementor users

Site Settings → Custom Code → Body End → paste your code

🌐Webflow

Go to Project Settings

Click "Custom Code" tab

Paste code in "Footer Code" section

Click Save & Publish

Re-publish your site ✅

⬜Squarespace

Go to Settings

Click "Advanced"

Click "Code Injection"

Paste code in "Footer" section

Click Save ✅

🔷Wix

Go to Settings in Wix dashboard

Click "Custom Code" (under "Advanced" section)

Click "+ Add Custom Code"

Paste your Beautimonial code

Set "Place Code in" → Body - End

Apply to: All Pages

Click Apply ✅

3. Collecting Testimonials

3.1 Hosted Collect Page (no code)

Every space comes with a hosted collect page — a shareable link that works without installing anything. Find it in Dashboard → Widget Settings and share it anywhere: email signatures, DMs, QR codes, invoices, thank-you pages.

https://beautimonial.com/t/your-space-slug

💡The collect page runs the same guided flow as the widget — Q&A, polish, and customer approval included.

Already have a review or comment box on your site? The inline widget adds a Beautify button inside your existing form instead of a floating button.

<script src="https://beautimonial.com/inline-widget.js?token=YOUR_TOKEN"></script>

Install the inline script

Paste the code above just before the closing </body> tag — same as the floating widget, different file.

Point it at your comment box

In Dashboard → Widget Settings, set the "Comment box CSS selector" to your form's text field (for example #review-text). Right-click your field → Inspect → Copy → Copy selector.

Done

A Beautify button appears next to your field. Customers polish their words without leaving your page, and the result lands in your Beautimonial dashboard.

3.3 Guided Q&A Flow

Instead of one blank box, Beautimonial walks customers through your questions one at a time — and turns the answers into a single polished story.

Set your questions per space in Dashboard → Widget Settings. Good questions follow the story arc: what problem did you have, what was it like using the product, what changed for you?

3.4 Honest Beautification

When your customer clicks Beautify, their words are polished for grammar, structure, and flow — and nothing else. Beautification never invents claims, numbers, or outcomes your customer didn't state. Here's the promise, step by step:

Constrained polish: the rewrite may only rearrange and clean up what the customer wrote — same facts, same numbers, same sentiment.
Verification pass: every polished version is checked against the original. Any number or claim that isn't in the customer's own words fails the check.
Safe fallback: if the check fails, we serve the customer's original words with a mechanical tidy-up (spacing, obvious typos) instead. Beautify never errors out on your customer.
Customer approval: the customer can edit the polished version and must approve it before it is submitted. Their original text is preserved unchanged, permanently.

✅Every testimonial keeps its original alongside the polished version — an audit trail you can stand behind.

3.5 Adaptive Follow-up Questions

Short reviews like "great product" are nice but don't convert. When a customer's answer is thin, the widget asks one or two quick follow-up questions — "what did it help you do?", "what changed for you?" — so the specifics come from the customer, not from us.

At most two follow-ups, and always skippable — no forced friction.
Answers are woven into the final testimonial, then polished as usual with the same honesty checks.
Nothing to configure — it works automatically in the widget and collect page.

3.6 Smart NPS Routing

With NPS enabled, customers first pick a 0–10 score. Customers who score you 7 or higher continue to the public testimonial flow; customers who score 0–6 are routed to a private feedback form instead.

Private feedback is emailed to you and never appears publicly.
All scores feed the NPS analytics on your dashboard.
Turn it on per space: Dashboard → Widget Settings → Smart NPS routing.

💡Praise goes public. Problems come to you first.

3.7 Importing Testimonials

Bring the testimonials you already have — from Google reviews, social posts, emails, or another testimonial tool. Dashboard → Import offers two modes:

Add one: paste a single testimonial with name, rating, and its original date.
Upload CSV: a file with a header row. Required columns: name and testimonial (or text/review). Optional: title, email, rating, date. You preview every row before anything is imported.

Imports are treated as owner-curated quotes: they go straight to Approved, exactly as written, with original dates preserved.

4. Displaying Testimonials

4.1 Gratitude Canvas

Your Gratitude Canvas is a hosted page showing every approved testimonial for a space, ready to share at a link:

https://beautimonial.com/wall/your-space-slug

It supports a light or dark theme and your accent color via URL parameters, e.g. ?theme=light&accent=%236366f1.

4.2 Embedding the Canvas

Drop the Canvas into your own site with an iframe that resizes itself to fit its content. Copy the ready-made snippet from Dashboard → Widget Settings → Embed.

<iframe src="https://beautimonial.com/wall/your-space-slug?theme=light"
  style="width:100%; border:none;" loading="lazy"></iframe>

On Pro and above, add &mode=carousel for a compact auto-rotating carousel strip instead of the full grid — ideal for a homepage or footer. The ready-made snippet is in Dashboard → Widget Settings.

Pulse shows small rotating toast pop-ups of real, recent testimonials to visitors as they browse your site — social proof at the moment it matters. It rides on the same widget script you already installed, so there's no second embed to add.

Turn it on and set the position, interval, and minimum rating in Dashboard → Widget Settings → Pulse.
Only approved testimonials appear, and timestamps are shown honestly (no fake "just now").
It sits below your collection button and respects your domain lock.

💡Pulse is available on Pro and above.

4.4 SEO Schema & AEO / llms.txt

On Pro and above, your widget automatically adds review structured data (JSON-LD) to the pages it runs on, so search engines can read your testimonials — no copy-paste needed. Turn it on in Dashboard → Widget Settings → SEO Schema & AEO.

AEO / llms.txt: Beautimonial also publishes an opt-in llms.txt feed of your approved testimonials at a public URL — an additional signal some AI answer engines check when they summarize what people say about you. It's an extra signal, not a guarantee of visibility.
Business generator: prefer to paste schema in yourself? The Business plan adds a copy-paste generator at Dashboard → SEO.

⚠️Star rich-results are never guaranteed by Google regardless of schema type — stars show only where a placement qualifies (e.g. Product markup on product pages). We implement the markup correctly for those placements and never oversell it.

4.5 Hiding the "Powered by" Badge

On any paid plan you can hide the "Powered by Beautimonial" badge on your widget and Canvas: Dashboard → Widget Settings → branding toggle. Free spaces always show the badge.

5. Dashboard Guide

5.1 Dashboard Overview

Your dashboard has these sections:

Home: usage stats (beautifications used), recent testimonials, quick actions, and your widget embed code
Testimonials: all testimonials in one place, filter by All / Pending / Approved / Waiting / Rejected — approve, reject, unpublish, or delete, and toggle between each testimonial's original and polished version
Import: bring in testimonials you already have — paste one at a time or upload a CSV
Widget Settings: register your domain, customize the widget, set your questions, toggle NPS and branding, and copy your embed codes
Analytics: views and conversion, testimonials over time, rating breakdown, beautification usage, and your NPS score, distribution, and trend
SEO: copy-paste review schema markup for your site (Business plan)
Billing: current plan, usage limits, upgrade options, cancel subscription

5.2 Managing Testimonials

Approving a testimonial

Go to Dashboard → Testimonials
Find testimonials marked "Pending"
Read the testimonial
Click "Approve" ✅ — it immediately appears on your website

Rejecting a testimonial

Find the testimonial
Click "Reject" ❌ — it will not appear on your website

Unpublishing or deleting

Approved by mistake, or want something off your wall? Unpublish takes a live testimonial off your site without losing it; delete removes it entirely.

Why can't I edit testimonials?

By design. Testimonials stay exactly as your customer approved them — that's what makes them trustworthy. Your customer edits and approves the polished version before submitting; from your side you approve, reject, unpublish, or delete. You can view each testimonial's original and polished versions side by side at any time.

💡Imported testimonials are the exception — you write those as owner-curated quotes during import.

5.3 Draft Reply

Replying to a review builds trust with everyone who reads it. From Dashboard → Testimonials, Draft Reply suggests a warm, on-brand reply to any testimonial that you can edit before you use it.

You approve every word — nothing is ever posted for you.
Every plan includes a reply allowance: Free covers 10 replies total, Starter 500/month, Pro 1,000/month, and Business 2,500/month (counted across your whole account). A replies-left badge shows what's remaining.
Replying on a comment that lives on your own live site? The dashboard can open an Admin Overlay so you can draft a reply right where the comment appears.

Everything about how you collect lives here:

Domain registration: enter your website URL to activate and lock the widget. Example: mywebsite.com (without the https:// prefix).
Appearance: widget color, position, and button text (Pro+) — dashboard controls are rolling out; email support@beautimonial.com and we'll set them for your account today.
Questions: the guided Q&A your customers answer, one at a time.
Smart NPS routing: the 0–10 pre-screen that sends detractors to private feedback.
Inline widget selector: the CSS selector of your own comment box, for the inline Beautify button.
Pulse widget (Pro+): turn on conversion-toast pop-ups and set their position, interval, and minimum rating.
SEO Schema & AEO (Pro+): auto-inject review structured data and expose your llms.txt feed.
Branding: hide the "Powered by Beautimonial" badge (paid plans).

5.5 Analytics

Dashboard → Analytics answers "is this working?" with real numbers:

Views & conversion: how many people saw your Canvas, collect page, and widget in the last 30 days — and what share of them became testimonials.
Testimonials & ratings: submissions over time and your rating distribution.
Net Promoter Score: your NPS with promoter/passive/detractor breakdown, 0–10 distribution, and a monthly trend — private detractor feedback counted honestly.
Usage: beautifications used against your monthly plan limit.

5.6 Pro & Business Tools

Every plan can create Social Media Cards and Animated Videos; higher plans add more tools:

Social Media Cards & Animated Videos (all plans): turn any approved testimonial into a branded Social Media Card (static image) or a short Animated Video (12-second, autoplay-ready .webm) in Dashboard → Brand Kit — or start one with “Create Social Card” on the Testimonials page. Style the logo, background, colors, fonts and per-element motion once. Square format on Free/Starter/Pro; all formats on Business. A single monthly allowance covers cards and videos together (5 / 50 / 100 / 500 by plan).
Industry-specific beautification (Pro+): set your industry in Dashboard → Widget Settings and polishing emphasizes what buyers in your space care about — still only using your customer's own facts.
Objection category tagging (Pro+): each testimonial is tagged by the buying objection it answers (price, trust, ease of use, results…), so you can pick the right proof for the right page.
Carousel widget (Pro+): embed your Gratitude Canvas as a compact auto-rotating strip — arrows, dots, pauses on hover — instead of the full grid. Copy the snippet from Dashboard → Widget Settings.
Pulse widget (Pro+): rotating conversion-toast pop-ups of recent testimonials, on the same widget script. Configure it in Dashboard → Widget Settings → Pulse. See Pulse Widget.
SEO schema auto-inject + AEO/llms.txt (Pro+): your widget adds review structured data automatically and Beautimonial publishes an llms.txt feed some AI answer engines check. See SEO Schema & AEO.
Objection-busting dashboard (Business): see which objections your testimonials cover — and which have no proof yet — so you know what to ask customers about next.
SEO schema generator (Business): Dashboard → SEO generates copy-paste review structured data for your site — a manual alternative to the Pro+ auto-inject above.
Export (Business): download all testimonials as CSV or JSON — including each one's original and polished versions. Your data stays portable.
Auto-approve (Pro+): skip the manual approval step so customer-approved testimonials go live immediately. The dashboard toggle is rolling out — email support to switch it on for your space today.

6. Plans & Billing

6.1 Plan Comparison

Plan	Price	Includes
Free	Free	10 live testimonials 1 domain Full widget & collect page Gratitude Canvas wall + embed Draft Reply (10 total) 5 Social Media Cards + Animated Videos/mo (square) Basic dashboard Beautimonial badge shown No card required
Starter	$9.99/month	1,000 beautifications/month 1 domain Gratitude Canvas wall + embed Draft Reply (500/month) 50 Social Media Cards + Animated Videos/mo (square) Remove branding Email notifications Basic analytics
Pro	$19.99/month	2,000 beautifications/month 2 domains Draft Reply (1,000/month) 100 Social Media Cards + Animated Videos/mo (square) Industry-specific beautification Objection category tagging Gratitude Canvas carousel widget Pulse conversion widget SEO schema auto-inject + AEO/llms.txt Auto-approve option Advanced analytics Priority support
Business	$39.99/month	Everything in Pro 5,000 beautifications/month 5 domains Draft Reply (2,500/month) 500 Social Media Cards + Animated Videos/mo (all formats) SEO schema generator (copy-paste) Objection-busting dashboard Export testimonials (CSV/JSON) Dedicated support
Agency	Custom	Custom beautification limits Unlimited* domains API access White-label option Contact agency@beautimonial.com

*Custom limits negotiated per account. Contact support@beautimonial.com to discuss what's right for your use case.

6.2 Free Plan & Your Wall

The Free plan caps how many testimonials are live on your site at once — 10 — not how many you can collect. Collection never stops:

Waiting status: once 10 are live, newly approved testimonials are held as "Waiting". They go live automatically when a slot opens — or all at once when you upgrade.
Wall-full email: we email you when your wall fills up, so you know social proof is piling up.
Downgrades are safe: if you move from a paid plan to Free with more than 10 live, nothing is unpublished — everything stays live; only new publishes wait for a slot.
Badge: Free spaces show the "Powered by Beautimonial" badge; any paid plan can hide it.

💡Your customers are never affected by plan limits — the review flow always completes normally, whatever plan you're on.

6.3 How to Upgrade

Dashboard → Billing → Upgrade Plan → select new plan → complete payment → new limits active immediately ✅

6.4 How to Cancel

Dashboard → Billing → Cancel Plan → confirm cancellation → access continues until billing period ends → no further charges → you move to the free plan and keep all your testimonials

6.5 Billing FAQs

Q: When am I charged?
A: Monthly, on the same date you subscribed. You receive an email reminder before each charge.

Q: Can I change plans anytime?
A: Yes! Upgrade or downgrade anytime from billing.

Q: What payment methods are accepted?
A: Credit cards, debit cards, UPI, net banking, and wallets via Razorpay.

Q: Do beautifications carry over?
A: No. Limits reset on the 1st of each month. Unused beautifications don't carry over.

7. Troubleshooting

7.1 Widget Not Showing

Issue: the "Leave a Review" button doesn't appear on my website.

Check 1: Is your embed code correct?

Go to Dashboard → Widget Settings, copy your embed code again, and make sure YOUR token is in the URL (not a sample token).

Check 2: Is your domain registered?

Dashboard → Widget Settings → Domain. Make sure your domain is saved, e.g. mywebsite.com (no https://).

Check 3: Is your subscription active?

Dashboard → Billing. Check your subscription is active and your domain is registered in Widget Settings.

Check 4: Is the code installed correctly?

The code must be in the HTML of your page, just before the closing </body> tag. Check for typos.

Check 5: Cache issue?

Clear your browser cache, try an incognito/private window, or try a different browser.

💡Still not working? Email support@beautimonial.com and include your website URL plus a screenshot.

7.2 Common Errors

Beautify button not working

Customer clicks Beautify but nothing happens. Possible causes:

Internet connection issue — refresh the page and try again
Browser blocking scripts — disable ad blocker temporarily
Widget code conflict with other scripts — contact support@beautimonial.com

Note: plan limits are never the cause — even at your limit, the customer flow completes normally.

Not receiving email notifications

Check your spam/junk folder and mark our emails as "Not Spam"
Verify your account email address is correct

Still not receiving? Email support@beautimonial.com

8. FAQ

Does my customer need to create an account?

No! Customers just visit your website, click the widget button, leave their review, and click Beautify. Zero signup required.

Can I edit beautified testimonials?

No — testimonials stay exactly as your customer approved them; that's what keeps them authentic. Your customer can edit the polished version before approving it. From your dashboard you approve, reject, unpublish, or delete.

What happens if I hit my monthly limit?

Your customers never notice. The review flow always completes normally — if a beautification limit is reached, we save the customer's words with a light tidy-up (spacing and typos only) and the testimonial still lands in your dashboard as usual. Upgrade anytime for a higher monthly allowance.

Does Beautify change what my customer actually said?

No. Beautification polishes grammar, structure, and flow — it never adds claims, numbers, or outcomes your customer didn't state. Every polished version is checked against the original, and if the check fails we fall back to your customer's own words, cleaned up mechanically. Your customer reviews and approves the final text before it ever reaches you.

What happens when my free wall is full?

Nothing breaks. With 10 testimonials live, newly approved ones are held as 'Waiting' — safely stored and ready to go live the moment a slot opens or you upgrade. We'll email you when your wall fills up. Customers can always keep submitting.

Can someone steal my widget code?

No. Your widget is domain-locked. It only works on your registered domain. If someone copies your code, it won't work on their website.

What happens to testimonials if I cancel?

Nothing is deleted. Cancelling moves you to the free plan at the end of your billing period — every live testimonial stays live (we never auto-unpublish), and if you have more than 10 live, new publishes simply wait for a slot.

Can I have the widget on multiple websites?

Yes! Pro plan supports 2 domains, Business plan supports 5 domains. Each domain gets its own widget settings.

Do you offer a free plan?

Beautimonial is free on the Free plan: collect testimonials and keep up to 10 live on your site at any time, no card required. Upgrade when your wall fills up.

How do I change my widget language?

Currently, Beautimonial supports English. Multi-language support is coming soon.

Can I collect testimonials without installing anything?

Yes! Every space has a hosted collect page at beautimonial.com/t/your-space-slug. Share the link in emails, DMs, QR codes, or invoices — no code needed.

Can I bring in testimonials I already have?

Yes. Dashboard → Import lets you paste testimonials one at a time or upload a CSV from Google reviews, social posts, or another testimonial tool. Original dates are preserved.

What happens when an unhappy customer leaves feedback?

With Smart NPS routing enabled, customers who score you 0–6 are routed to a private feedback form instead of the public flow. Their feedback is emailed to you and never appears publicly.

Is there an API available?

API access is available on our Agency plan. Contact support@beautimonial.com for details.

💬

Can't find what you're looking for?

Our support team is here to help.

Email: support@beautimonial.com
Response: Within 24 hours

Contact Support →