> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Bring the rows of your Notion databases into your own Custral objects, once or kept in sync.

## What it does

Notion brings **data** into Custral. The rows of the Notion databases you share become records in objects your workspace already has, for example a Notion **Tasks** database into your **Tasks** object. Changes made in Notion can keep arriving after that. Edits made in Custral are not sent back to Notion.

Notion pages (documents) do not come over, and no new objects are created for your databases.

Custral asks Notion only to **read content** and to **read user information including email addresses** (so a Notion person can be matched to a teammate). It cannot edit, create or comment on anything in Notion.

## Connect

<Steps>
  <Step title="Set up Notion">
    Open **Settings → Integrations → Notion** and click **Setup Integration**. Choose what you want it for: bring data in, keep it in sync, and whether Stella may search Notion for you.
  </Step>

  <Step title="Pick what to share">
    Notion asks which pages to share. Tick the pages that hold your databases; everything under them comes along. Custral only ever sees what you tick here.
  </Step>

  <Step title="Bring data in">
    Back in Custral, Stella opens beside the page with what Notion shared and where each database most likely goes. It shows the column mapping and a dry run before anything is written, then runs the import. You can **Undo** an import from the same chat.
  </Step>
</Steps>

You can start again any time from **Bring data in from Notion** on the integration page.

## How columns come over

| Notion property | Comes over as |
| - | - |
| Title | The record's name |
| Text | Text |
| Number | Number, or currency when the Notion number has a currency format |
| Select, Status | A select, with the same options |
| Multi-select | Its labels, for a multi-select |
| Checkbox | Yes / No |
| Date | A date (a date range keeps its start) |
| Person | A teammate, matched by email |
| Email, Phone, URL | Email, phone, website |
| Formula, ID, Created time, Last edited time | Their value, read-only |
| Relation | Skipped for now: Custral does not yet link the related records |
| Files, Rollup, Button | Not imported |

Stella suggests where each column goes and what type a new property should be; you can change either in the mapping. New properties and new select options are only created when you confirm them, and **Undo** removes them again.

## Keep in sync

After an import, choose **Keep in sync** in the chat, or tick it at setup. Edits in Notion then arrive on their own, usually within a few minutes, plus a full check every 6 hours. The tables that keep syncing are listed on the integration page's **Kept in sync** tab, with **Stop syncing** and **Sync now**.

## Limitations

* **One way only.** Changes in Notion come into Custral; edits in Custral stay in Custral.
* **Synced fields are read-only** in Custral while Keep in sync is on. Change them in Notion, or stop syncing.
* **Deletes don't carry over.** A row deleted in Notion stays in Custral.
* **Relations aren't linked yet.** A relation column is skipped rather than imported as text.
* **Pages don't come over**, only database rows.
* The connection reads what the person who connected it can see and shared. If they lose access in Notion, syncing stops until somebody reconnects.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| A database is missing | It wasn't shared when connecting. | Reconnect Notion and tick its page in Notion's page picker. |
| A field won't save on a synced record | Keep in sync owns that field. | Edit it in Notion, or stop syncing on the **Kept in sync** tab. |
| A person column is empty | Nobody in the workspace has that Notion person's email. | Invite them, or map the column to a text property. |
| Edits in Notion don't arrive | The connection lost access, or a sync paused. | Check the **Kept in sync** tab; reconnect Notion if asked. |

## Disconnect

Uninstalling Notion stops every sync and removes the connection. Imported records stay in Custral and stop receiving updates.

## See also

* [Importing records](/data/records/import)
* [Integrations overview](/integrations/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.