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

# Connect your app to Notion

> Connect your app to Notion, an all-in-one workspace for docs, wikis, and databases, to read and write pages, query databases, and build apps backed by content your team manages in Notion.

export const connector_0 = "Notion"

[Notion](https://www.notion.so/) is a workspace for docs, wikis, projects, and databases. The Notion app connector lets your Lovable app reach the pages and databases your team has shared with it, so you can build apps that turn Notion content into a customer-facing experience or push structured data back into Notion as your source of truth.

<Note>
  This is the **Notion app connector** for apps you build with Lovable. Your generated app reads and writes Notion content at runtime.

  Want the Lovable Agent to read your Notion docs while building instead? Use the [Notion chat connector (MCP)](/integrations/mcp-servers) — a separate integration with its own setup.
</Note>

With Notion, your app can:

* Read pages, blocks, and rich text from your Notion workspace
* Query Notion databases with filters, sorts, and pagination
* Create new pages and append blocks to existing pages
* Update database rows (for example, status, owner, due date)
* Drive content-managed sites and dashboards where editors work in Notion

Each Notion connection is authorized for a single Notion workspace and only sees the pages and databases that were explicitly shared with the integration during authorization. You can create multiple connections to work across multiple workspaces or to separate environments.

## Common use cases and example apps

| Example app                     | Example prompt                                                                                                                              | Description                                                                                                                                                                           |
| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Marketing site backed by Notion | *Use Notion and build a marketing site that pulls landing pages and a blog from a Notion database.*                                         | **Render a marketing site from content managed in Notion.**<br />The app fetches pages by slug, renders the matching components, and lets editors ship updates without touching code. |
| Internal knowledge base or wiki | *Use Notion and build a searchable knowledge base from our company wiki in Notion.*                                                         | **Turn a Notion wiki into a fast, searchable site.**<br />The app reads the page tree, builds navigation, and renders rich text and embedded blocks for each article.                 |
| Customer-facing help center     | *Use Notion and build a help center that lists articles by category from a Notion database.*                                                | **Publish help articles from Notion with a clean reading experience.**<br />The app paginates by category, renders rich text, and surfaces metadata managed entirely in Notion.       |
| Project tracker dashboard       | *Use Notion and build a project tracker that shows tasks from our Notion database, grouped by status, with filters for owner and due date.* | **Bring a Notion database to life as a focused dashboard.**<br />The app queries the database, groups and filters rows in the UI, and lets the team see progress at a glance.         |
| Lead capture form into Notion   | *Build a lead capture form. When someone submits it, create a new row in our Leads database in Notion.*                                     | **Push form submissions into a Notion database.**<br />The app validates the input and writes a new page in the target database so sales can work the lead from Notion.               |
| Editorial content site          | *Use Notion and build a blog that lists articles from a Notion database, supports tag filtering, and renders rich text.*                    | **Build an editorial reading experience driven by Notion pages.**<br />The app paginates posts, filters by tag, and renders rich text and embedded blocks.                            |
| Status page or changelog        | *Use Notion and build a public changelog that pulls release notes from a Notion database.*                                                  | **Let the team write release notes in Notion and surface them publicly.**<br />The app reads new entries, renders them in chronological order, and exposes an RSS-style feed.         |

## How Notion connections work

Lovable uses one centrally managed Notion app to power all Notion integrations across workspaces. Within your Lovable workspace:

* You can create multiple Notion connections.
* Each connection is a separate OAuth authorization tied to a single Notion workspace.
* Each connection only sees the pages and databases shared with it during authorization — it cannot reach other content in that Notion workspace.
* Multiple projects within a single Lovable workspace can use the same connection.

This makes it easy to separate environments (for example, development and production) or work with multiple Notion workspaces from the same Lovable workspace.

Notion uses Lovable's gateway architecture for secure OAuth handling and automatic token refresh. See [Gateway-based connectors](/integrations/introduction#gateway-based-connectors) for details on authentication and usage limits.

## How to connect Notion

Workspace **admins** and **owners** can connect Notion.

### Prerequisites

Before connecting Notion, make sure you have:

* A Notion workspace where you can install integrations (or request admin approval)
* Permission in Notion to share the pages and databases your app needs
* Lovable workspace **admin or owner** role

<Info>
  All API requests made through this connector go to your Notion workspace. Notion API usage counts toward your Notion plan limits and is handled directly by Notion, not Lovable.
</Info>

### Step 1: Decide what to share with the integration

Notion only exposes content that has been **explicitly shared with the integration**. Before authorizing, decide which pages and databases your app should be able to read or write.

<Tip>
  Share a single top-level page (or database) and let your app reach everything beneath it via Notion's normal inheritance, rather than sharing many pages individually.
</Tip>

### Step 2: Connect Notion to Lovable

You can create multiple connections to authorize different Notion workspaces or to keep environments separate.

<Steps>
  <Step title="Open Notion in Connectors">
    Go to **Connectors** → **App connectors** and select **Notion**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Configure the connection">
    * **Display name**: name the connection, for example `Notion Prod`.
    * **Who can access this connection**: keep access limited to specific people or invite the entire workspace. See [Who can manage connections](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="Connect to Notion and authorize">
    * Click **Connect**. The Notion authorization window opens — make sure your browser doesn't block pop-ups.
    * Sign in to Notion if needed and select the workspace you want to connect.
    * On the **Select pages** screen, choose the pages and databases your app should be able to access. You can update this later from inside Notion.
    * Review the requested permissions and click **Allow access**. You'll be redirected back to Lovable with a confirmation.
  </Step>
</Steps>

When connected, your Lovable apps can start reading and writing Notion pages and databases.

## Working with shared pages and databases

Notion's permission model is opt-in: an integration can only see what's been explicitly shared with it.

* If your app is missing content it should be able to see, share the page or database with the integration in Notion (**Share** → **Connections** → **Add connections**).
* Sharing a parent page automatically shares its sub-pages with the integration.
* You can revoke access from inside Notion at any time without removing the Lovable connection — the connection stays connected, the integration just sees less content.
* Pages your app creates or updates are attributed to the integration in Notion's page history, not to an individual user.

<Tip>
  When prompting Lovable, be explicit about which database or page the app should use, for example: *"use the Tasks database to populate the dashboard"*.
</Tip>

## Limitations

The Notion connector cannot:

* Receive incoming Notion webhooks or events (for example, "page updated" notifications)
* Reach pages or databases that haven't been shared with the integration
* Authenticate per end user — each connection uses a single Notion authorization shared by everyone using the app
* Perform Notion workspace administration (member management, permissions, billing)

<Warning>
  Multiple connectors that share the same Notion login and Notion workspace also share page permissions, and the most recently configured connector overwrites the permissions for all of them.
</Warning>

If your app needs realtime reactions to changes in Notion, build a polling pattern (for example, query the database on a schedule) instead of relying on push events.

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>