The handoff message for whoever edits your site
Ask Your Developer to Add Testimonials
You picked the testimonials and built the widget. Now someone else has to put it on the site, and the first reply is usually a question: which page, where on it, and is there anything else to install? Fill in the builder below and send one message that answers all of it, with the code already inside, so the job takes your developer ten minutes rather than three emails.
- The embed code written into the message for you
- Page, position and done criteria in plain words
- Versions for in-house, freelance and multi-page jobs
Message builder
Write the request your developer can act on
Copy the widget id from StoryProof, fill in the page and the spot, then copy the message.
- Quick ticket for a colleague
Subject: Testimonial widget on [https://example.com/pricing] by [Thursday]
Hi [Sam], Could you add our testimonial widget to [https://example.com/pricing], [directly under the plan comparison table, above the FAQ]? It is two lines of HTML, nothing to install: <div data-storyproof-widget="[your-widget-id]"></div> <script src="https://app.storyproof.io/embed.js" async></script> The div goes where the testimonials should appear. The script can sit once in the shared footer instead of next to the div, if that is how we load other scripts. Done means: the widget shows on the live page on desktop and mobile, and nothing else on the page moves or breaks. Thanks, [Priya]
- Follow-up when it is live
Send after you have checked the page yourself.
Thanks [Sam], it is showing on [https://example.com/pricing]. If you ever rebuild that template, the div with id [your-widget-id] needs to come across with it, or the section will go blank. [Priya]
What you type stays in this browser tab. Nothing is sent or stored.
The problem, solved
Why testimonial handoffs bounce back, and what to put in the message
- Problem 1
They asked what to install first
Developers expect a plugin, package or API key and lose time looking for one.
How StoryProof solves it
Say in the first line that there is nothing to install. The widget is two lines of HTML: a div with the widget id and the async embed.js script.
- Problem 2
The script ended up on the page twice
Each widget was pasted with its own script, so pages with two widgets load the same file twice.
How StoryProof solves it
Ask for the script once per page, ideally in the shared footer. It fills every StoryProof widget div on that page.
- Problem 3
They asked us to send the quotes
Some developers assume they must type the testimonials into the page, which turns a quick paste into a content job.
How StoryProof solves it
Tell them the selection is made in StoryProof. You choose which approved testimonials appear in the widget; the developer only places it.
- Problem 4
It landed in the wrong spot
"On the pricing page" leaves a developer to guess between the top, the sidebar and the footer.
How StoryProof solves it
Name the element it sits under and above. The div shows the widget exactly where it is pasted, so a precise spot gives a precise result.
- Problem 5
The client noticed a badge we did not mention
An agency installs the widget for a client who then asks about a small credit line under it.
How StoryProof solves it
Mention it in the brief so nobody is surprised. Widgets per workspace: Free 1, Starter 5, Pro unlimited. A small "Powered by StoryProof" badge shows until Pro.
A filled-in brief
Illustrative sample, not a real customer
Hi Sam, could you add our testimonial widget to the pricing page, directly under the plan comparison table and above the FAQ, by Thursday?
Nothing to install: one div and one script line, both below. Our footer already loads the script for the homepage widget, so only the div is needed here.
Done means it shows on the live page on desktop and mobile with nothing else moving.
- Page
- Pricing
- Position
- Under the comparison table, above the FAQ
- Script
- Already in the footer
In StoryProof
Before you press send
Step 1 of 4
Finish the selection first
Choose the approved testimonials for the widget before the developer starts, so the first look on the live page is the real one.
Step 2 of 4
Copy the widget id
Take the id from the widget’s embed code in StoryProof and paste it into the builder above.
Step 3 of 4
Check whether the script is already on the site
If another widget is live, the footer may already load embed.js. Say so in the message so it is not added twice.
Step 4 of 4
Look at the page with the developer’s eyes
Open the page, find the exact element the widget should follow, and use its visible heading in the "where" field.
Before you start
What the message cannot do for you
It does not cover every builder
Some website builders strip scripts or put custom code in a frame. Your developer knows your platform; the message leaves the method to them.
It does not test the result
A clear brief reduces mistakes but someone still has to look at the live page. If the widget stays blank, the troubleshooting page is the next stop.
It assumes one widget id
A different selection on another page means another widget and another id. Send one message per widget to keep them apart.
It does not cover consent tools
If your site runs a consent manager, ask the developer how it treats new scripts before the widget goes live.
FAQ
Questions people ask
Short answers to what usually comes up next.
Does my developer need a StoryProof account?
No. They need only the two lines of code in the message. You keep the account and the testimonial selection.
Can the developer put the script in the site header instead?
The script is async, and it needs to load once on any page that has a widget div. A shared footer is the usual place; the header works too if that is how your site loads scripts.
What if the developer wants to restyle the widget with our CSS?
Start by choosing a layout in StoryProof that fits the page. Ask the developer to tell you before overriding any styles, so later changes on your side do not clash with theirs.
How do I add the same widget to more pages later?
Send the "Several pages" version. Once the footer loads the script, each new page needs only the div.
Still have a question? Ask the StoryProof team or book a demo.
Build the widget, then hand it over
Choose your testimonials and layout in StoryProof, and send your developer two lines of code.
Last updated 2026-11-13.