Connect your Notion database
Two paths — pick whichever matches you.
Don't have a database yet
Use our template
One click duplicates a ready-made Testimonials database into your workspace with the right columns and 2 sample rows. The fastest path to a working widget.
Already have a database
Map your existing columns
Share your database with the NotionProof integration, pick it on the New Widget screen, and map your columns to our fields. We auto-guess; you confirm.
Field mapping cheatsheet
Only Name and Testimonial are required. Everything else is optional — if a column doesn't exist or you leave it unmapped, that piece simply doesn't render. We try to auto-detect every field by column name and type; you can override any guess via the dropdown.
| Field | Notion column type | Auto-match if your column is named… | Notes |
|---|---|---|---|
| Namerequired | Title | name, customer, client, author, by, from, reviewer | Notion's default Title column. If no obvious name column exists, we use the Title. |
| Testimonial / Quoterequired | Text (rich_text) or Title | testimonial, quote, review, feedback, comment, message, content, body | The actual testimonial body. Plain text or rich text both work. |
| Photo / Avatar | Files & media OR URL | photo, avatar, image, headshot, picture, profile pic | We use the first attached image, or a direct URL. Leave blank for an initial-letter fallback. |
| Video | URL OR Files & media | video, recording, loom, youtube, vimeo, clip, video url | Loom / YouTube / Vimeo links auto-embed as players. Direct .mp4/.webm/.mov files render as HTML5 video. |
| Rating | Number (1–5) or Select | rating, star, stars, score | Numbers render as stars. Select values like "5" or "4 stars" also work. |
| Company | Text or Select | company, org, organization, employer, business | Shown below the name on each card. |
| Date | Date, Created time, or Last edited time | date, received, created, posted, when, on | Used for sort order. Display can be toggled on/off. |
| Source URL | URL | url, link, website, source, tweet, post | Link to the original tweet, LinkedIn post, or review page. |
Common mapping scenarios
My Notion DB has 'Feedback' instead of 'Testimonial'
No problem. On the schema mapping screen, click the Testimonial / Quote dropdown and select 'Feedback'. The auto-detect won't match it (the regex doesn't include 'feedback'… actually wait, it does — so this case should work automatically). Either way, you can always override manually.
Photos are in a 'Headshot' files column
Auto-match should catch 'Headshot'. If not, manually pick it in the Photo / Avatar dropdown. The first attached file is used. JPGs, PNGs, and external URLs all work.
My ratings are in a Select column ('5 stars', '4 stars', '3 stars')
Select column values that start with a number get parsed automatically — '5 stars' = 5, '3 stars' = 3. If they're plain numbers like '5', that also works.
I don't track ratings at all
Skip the Rating dropdown (leave it unmapped). On each card you can toggle 'Show star rating' off in the dashboard, so nothing renders.
My DB has 100+ columns I don't want to show
Doesn't matter — we only read the columns you've mapped. The other 100 stay private in your Notion workspace.
📋 Want to start from a known-good shape?
Duplicate our template into your workspace and you'll have all 7 columns ready with the right names and types — auto-detect picks up everything on first load.
Open Notion template →