Field mapping cheatsheet
NotionProof reads your existing Notion database — we don't restructure it. On the New Widget screen, you map your columns to our display fields. Only Name and Testimonial are required. We auto-detect every field by column name and column 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 | The Title column of your database (always required by Notion). If no obvious name column exists, we fall back to 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 | 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. |
| 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 scenarios
My column is named 'Feedback' instead of 'Testimonial'
Auto-match catches it (the regex covers feedback / quote / review / comment / message / content / body). If it doesn't, click the Testimonial / Quote dropdown and pick your column manually.
Photos are in a 'Headshot' files column
Auto-match catches 'Headshot' too. The first attached file is used. JPGs, PNGs, and external URLs all work.
My ratings are in a Select column ('5 stars', '4 stars')
Select values that start with a number get parsed automatically. Plain numbers like '5' also work.
I don't track ratings at all
Skip the Rating dropdown. In the editor, toggle "Star rating" off so nothing renders.
My DB has 100+ columns I don't want to show
Doesn't matter — we only read the columns you map. The other 100 stay private in your workspace.
I want to show only approved testimonials
See the FAQ entry "Can I show only some rows on my widget?" — short answer: use two databases (collection + display) and move approved rows over. We're considering a Featured-row filter for v1.1.