# Notion
## Notion Connector Guide
This guide provides an overview of how to connect Whalesync to Notion and answers common questions.
### Connecting to Notion
To connect Whalesync to Notion, you will need to authenticate using your Notion account. This process uses OAuth, which is a secure way to grant Whalesync access to your data without sharing your password.
When you authorize the connection, you will be taken to Notion's website. There, you can select which workspace and which specific pages or databases you want Whalesync to be able to access. Whalesync will only have permission to read and write to the pages and databases you explicitly select.
### Syncing Data
Whalesync enables two-way synchronization for most Notion fields. This means that if you update a record in Notion, the change will be reflected in the connected application, and if you update a record in the other application, the change will be reflected in Notion.
Some fields in Notion, such as `Created time` or `Last edited by`, are inherently read-only. Whalesync can read data from these fields and sync it to other apps, but cannot write new data into them. For a detailed list of what is supported, please see the "Supported Fields" section below.
#### Automatic Table and Field Creation
Whalesync can automatically create tables and fields in Notion to match the structure of the other app you're syncing with.
### Things to Keep in Mind
#### Relation fields
Whalesync supports relation fields out of the box! Note - Notion requires the "Two-way relation" option to be toggled in order for them to work.
#### Page Content Syncing
Whalesync can [sync the full content of your Notion pages](https://docs.whalesync.com/connectors/notion/notion-page-sync). However, there are limitations for pages with very high complexity (i.e. a large number of nested blocks). If you have issues syncing complex pages, please contact support.
Note that the Notion API is significantly slower than most other APIs. When syncing page content across large databases (thousands of pages), sync times can be much longer than usual because each page requires multiple API calls to fetch its full block content. For best performance, keep your synced Notion databases small and focused. See [Notion page sync](https://docs.whalesync.com/connectors/notion/notion-page-sync) for more details.
#### Rollup Fields
Syncing data from Notion's rollup fields is not yet supported.
#### Auto-Creating Databases
If you use Whalesync's "Auto-create tables" feature to create a new database in Notion, you will need to have specified a parent page when authenticating with Notion. This tells Whalesync where to place the new database.
### Synthetic Fields
Whalesync adds a few read-only fields to your Notion data to help manage the sync. These fields are not present in Notion itself but are available in Whalesync.
| Field Name | Description | Writable |
| ---------------- | ------------------------------------------------------------------------------------------------- | -------- |
| Notion Record ID | The unique identifier for a page in Notion. This is used by Whalesync to track records. | No |
| Page Content | The full content of a Notion page, including text, images, and other blocks, represented as HTML. | No |
| Created At | The timestamp of when a record was first created by the sync. | No |
| Updated At | The timestamp of when a record was last updated by the sync. | No |
## Supported Fields