# Notion

Add submissions to a Notion database, with each field mapped to a property. Each submission becomes a new page with an optional body, and past submissions can be copied in.

## What you get

- One Notion page per submission
- Each field mapped to a database property
- An optional page body built from the answers
- Past submissions copied in when you connect
- Mappings that keep working when you rename a property

## Connect Notion

1. **Open Integrations**

   Click **Integrations** (plug icon) in the form's top bar, then pick Notion.

2. **Workspace and database**

   Pick a connected Notion account, or click **Connect Notion workspace**. Share the database with Formstep there: Formstep sees only the databases you share. Then pick the database.

3. **Properties**

   Match each form field to a Notion property. Only properties of a compatible type are listed. You can also write a page body.

4. **Turn it on**

   Under **More options**, turn on **Export existing submissions** to copy past responses. Click **Turn on Notion**, then **Send test** to create a placeholder page.

## Property types

| Form field | Compatible Notion properties |
| - | - |
| Short / long text | Title, Rich text |
| Email | Email, Title, Rich text |
| Phone | Phone, Title, Rich text |
| URL | URL, Title, Rich text |
| Number / Rating / Scale | Number, Title, Rich text |
| Date | Date, Title, Rich text |
| Time | Title, Rich text |
| Radio / Dropdown (single) | Select, Status, Title, Rich text |
| Checkboxes (multi) | Multi-select, Title, Rich text |
| Toggle switch | Checkbox, Title, Rich text |
| File upload | Files, URL, Title, Rich text |
| Signature | URL, Title, Rich text |
| Picture choice | Multi-select, Title, Rich text |
| Matrix / Ranking / Payment | Title, Rich text |

### Metadata properties

| Metadata | Compatible Notion properties |
| - | - |
| Submitted at | Date, Title, Rich text |
| Respondent email | Email, Title, Rich text |
| Submission ID | Title, Rich text |
| Form name | Title, Rich text |
| Submission status | Status, Select, Title, Rich text |
| PDF Link | URL, Files, Title, Rich text |
| Submission language | Title, Rich text |
| Channel | Select, Title, Rich text |
| Request ID | Title, Rich text |

Channel reads “Public link” or “Request”. Request ID holds the id of the request the response answered. Use them to separate the two kinds of response.

## Repeating groups

Map a [repeating group](https://formstep.io/docs/building-forms/repeating-groups/) in either or both ways:

- The whole group maps to one Rich text or Title property. Every item shows as numbered, labeled rows, like “1. Full name: Jane Appleseed, Age: 34, 2. Full name: Marcus Lee, Age: 29”.

- Each member field maps to its own property. The values from every item join with `· `, so the Full name property reads “Jane Appleseed · Marcus Lee”.

## Rich page body

You can write the page body in the template editor. Type **@** to insert an answer or metadata, such as PDF Link.

You can use paragraphs, **bold**, _italic_, _underline_, and links. Headings, lists, and images show as plain paragraphs.

## Test event

**Send test** creates a real page of placeholder values in your database. Delete the test page when you are done.

## Backfill existing submissions

Past submissions are copied in the background. The integration shows the progress.

## Unfinished drafts

On Pro and Business, Notion can also add [unfinished drafts](https://formstep.io/docs/submissions-analytics/partial-submissions/#unfinished-drafts), set under **More options** › **Unfinished drafts**. To tell them apart, map Submission status to a Status or Select property: it reads “Partial”, “Completed” or “Updated”.

## Property changes in Notion

- Rename a property: the mapping updates on the next submission.

- Delete a property: Formstep drops it from the mapping and syncs the other fields.

- Change a property to an incompatible type, for example number to select: that value can fail to sync. Open the integration and map the field again.

## When something goes wrong

- If a database is missing from the list, connect again and share the database with Formstep on Notion’s consent screen.

- If a value does not sync, its property has a type that does not fit. Open the integration to see which field to fix.

- If you remove Formstep in Notion, under Settings › Connections, the integration stops and the person who set it up gets an email. Connect again to restore it.

- When Notion is busy, Formstep retries on its own. For retries and pausing, see [Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/).

## FAQ

**Does Formstep create the database for me?**

No. Create the database in Notion first, then share it with Formstep during authorization.

**What happens if I delete the Notion database?**

The next submission fails with a “not found” error and the integration stops. You cannot change the database later. Delete the integration and create a new one for the new database.

**Can other workspace members see my Notion connection?**

Yes. Notion accounts are connected to the workspace. Any member can use any connected account in an integration.

**Can I connect multiple Notion accounts?**

Yes. The workspace owner connects more Notion workspaces, from Integrations or during setup. Each form picks one account.

**How do I remove the integration?**

Open Integrations, pick Notion under **On this form**, and choose **Delete integration** in the ⋯ menu. To also revoke Formstep’s access, remove Formstep in Notion, under Settings › Connections.

## Next steps

[Airtable](https://formstep.io/docs/integrations/airtable/) — Add each submission to an Airtable base

[Google Sheets](https://formstep.io/docs/integrations/google-sheets/) — Add each submission to a spreadsheet as a row

[Repeating groups](https://formstep.io/docs/building-forms/repeating-groups/) — Let respondents add as many items as they need

[Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/) — Retries, pausing and reconnecting