How to Add Testimonials to a Notion Page With an Embed
Notion works as a writing, planning and publishing space, and it can host a public page. If you want customer praise to appear on that page, the simplest route is a hosted testimonial wall that you place inside Notion as an embed. This guide covers the two inputs you need, the three layout paths, and how to tell a publishing problem from a URL problem.
What you need before you start
Two things must be ready before the embed will display anything:
- A published testimonial wall with a wall URL you can copy.
- A Notion page where you can add an embed block.
The wall itself is built in a testimonial tool. You create the wall, bring in testimonials from available sources or gather them through a personalized collection link, and adjust how text and video testimonials look. Publishing the wall is a separate action from building it; the wall URL is only useful once that publish step has happened.
Build and publish the wall
In the testimonial dashboard, create the wall and customize its appearance. When the design is ready, use the publish control, then copy the wall URL from the dashboard. Keep that URL separate from the embed URL you will paste into Notion: the wall URL identifies your collection, while the embed URL adds a layout path in front of it.
Add an embed block in Notion
Open the Notion page and insert an embed block, either from the plus menu or by typing the embed command. Notion then asks for a link. Paste one of the layout URLs described below rather than the bare wall URL, because the layout path is what tells the widget how to arrange the testimonials.
Choose a layout path
Three layout paths are available. Each one takes the same wall identifier:
- Grid:
{{EMBED_BASE_URL}}/wall/{wall_url} - Carousel:
{{EMBED_BASE_URL}}/carousel/{wall_url} - Dual slider:
{{EMBED_BASE_URL}}/slider/{wall_url}
Use the pattern as written and substitute only your own wall identifier for {wall_url}. After the widget loads, resize the block so it fits the page.
Worked example: swapping in your wall identifier
Suppose your published wall URL ends with a short identifier such as my-wall. Keeping the layout path and replacing {wall_url} with that identifier gives three possible embed links:
- Grid:
{{EMBED_BASE_URL}}/wall/my-wall - Carousel:
{{EMBED_BASE_URL}}/carousel/my-wall - Dual slider:
{{EMBED_BASE_URL}}/slider/my-wall
Paste the single link that matches the layout you want. Do not paste all three into the same block, and do not assume a real destination exists until your own wall has been published and its URL copied.
Decision checklist
Use these questions to pick a layout and confirm the setup:
- How many testimonials will appear at once? A grid shows several side by side; a carousel or slider shows fewer at a time.
- How much vertical space does the Notion page allow? Resize the block after the first load and check the result on a narrow screen.
- Does the wall include video testimonials? Confirm they render inside the embed rather than only on the hosted wall.
- Is the wall published? If the embed is blank, check publishing before changing the URL.
- Does the embed URL use the layout path that matches the design you chose? A grid path will not produce a carousel.
Blank embed or wrong layout? Two different problems
A blank embed usually points to the wall, not the block: the wall may not be published, or the copied URL may be incomplete. A widget that loads but looks unlike the design you expected usually points to the layout path: grid, carousel and dual slider are separate embed paths, and mixing them up changes the arrangement. Check the wall URL first, then the layout path, before rebuilding the block.
Field map for the embed
The setup has two inputs and one output:
- Input: published wall URL, copied from the testimonial dashboard.
- Input: layout path, chosen from grid, carousel or dual slider.
- Output: an embed link pasted into Notion's embed prompt.
Everything else, including the appearance of text and video testimonials, is configured on the hosted wall before publishing.
Frequently asked questions
Can I paste the wall URL directly into Notion?
The embed prompt expects a layout URL, not just the wall URL. The wall URL identifies your collection; the layout path tells the widget whether to show a grid, carousel or dual slider.
Does this require any coding?
No. You build and publish the wall in the testimonial tool, copy the embed link, and paste it into a Notion embed block.
Can the wall include video testimonials?
Yes. The wall can be customized for text and video testimonials before publishing, and the embed displays the published wall.
How do I make the widget fit my page?
Once the widget loads in Notion, resize the embed block until it fits the page layout.