> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.noteforms.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshooting Notion Database Connection Issues with NoteForms

If you're experiencing connection issues with your Notion database on NoteForms, follow this comprehensive guide to identify and resolve the problem.
---

## Accessing the Troubleshooting Page

To start troubleshooting:

1. **Visit the Troubleshooting Page**: Go to [NoteForms Troubleshooting](https://noteforms.com/settings/troubleshooting).
2. **Select the Workspace**: In the top navigation bar, choose the appropriate workspace linked to the form experiencing issues.
3. **Start Troubleshooting**: Click the **"Start Troubleshooting"** button to view a detailed table of forms, their associated databases, and the connection status.

The table will display the following columns:
* **Form Id**: Unique identifier for the form.
* **Form**: A link to the form.
* **Database**: A link to the Notion database.
* **Creator**: The email of the form creator.
* **Status**: Current connection status.
* **Error**: The specific error encountered, if any.

### Identifying the Problem

Check the **Status** and **Error** columns for any issues. Common errors include:

1. **Expired/Revoked**
2. **Resource Not Found**
---

## Resolving Common Issues

### 1. Expired/Revoked Connection

This error indicates that the Notion connection granted by the form creator has expired or been revoked.

#### Resolution:

* **If the form creator is still part of your organization:**
  
1. The creator must log in to NoteForms.
  
2. Navigate to the [Workspace Settings Page](https://noteforms.com/settings/workspaces).
  
3. Click **"Connect a workspace"** and re-connect the Notion workspace. **Do not remove the workspace.**
  
4. Follow this [detailed guide](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/) to ensure proper connection.

* **If the form creator is no longer part of your organization:**
  
1. Take ownership of the form:
    * Find the form in the [list of forms](https://noteforms.com/home) and click on it.
    * Open the share page and access **Advanced Options** by clicking the **[…]** button.
    * Select the **"Take Ownership"** option.

![Take Ownership](https://storage.crisp.chat/users/helpdesk/website/5d91dadd0b88a000/image_12sa7m2.png)

2. After taking ownership, click the **"Submissions"** button on the share page to open the associated Notion database.
  
3. Ensure the database is properly shared with the NoteForms integration. Follow this [sharing guide](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/).

#### Important notes

* If troubleshooting shows **Expired/Revoked**, re-connect the **workspace** from **Workspace Settings**.
This error suggests that the connection is valid, but NoteForms cannot access the form’s Notion database. Common causes include:
* The database is no longer shared with the integration.
* The database was moved to a location not shared with the integration.
* Pages used by Relation properties are not shared with the NoteForms integration.

#### Resolution:

1. Re-share the database with the integration. Follow this [step-by-step guide](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/) to ensure proper sharing.
2. Confirm the database’s location in the workspace is accessible to the integration.
3. If your form uses Relation fields, make sure the related pages are also shared with NoteForms. In Notion, go to **Workspace settings** → **Connections** and share the required pages with the NoteForms integration. If needed, use Notion’s bulk sharing options.
4. After updating sharing permissions, submit the form again and check the Troubleshooting page for any remaining access errors.
---

## Additional Resources
#### Resolution:

* [How to Share a Notion Database with NoteForms](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/)
* [Detailed Troubleshooting Guide](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/)

For further assistance, feel free to contact NoteForms support.
## If the form editor shows a technical error

If you see an error while opening or editing a form, first identify the last action performed before the error appeared. This is especially useful when the issue happens after adding a block, dragging a field, opening the editor, or editing a published form.

If the form is linked to Notion and the editor cannot load or shows an unexpected error, disconnect and reconnect the NoteForms integration for the connected Notion database, then make sure the database is shared correctly with the integration:
* [How to reset the connection with Notion?](https://help.noteforms.com/en/article/how-to-reset-the-connection-with-notion-5e7drv/)
* [I cannot find my Notion database](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/)

If the issue continues, share the form URL and a screenshot or video showing the error.

By following this guide, you should be able to resolve most database connection issues and ensure your forms work seamlessly with Notion.
If the above steps do not resolve your issue, consult the following resources:
* [How to Share a Notion Database with NoteForms](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/)
* [Detailed Troubleshooting Guide](https://help.noteforms.com/en/article/i-cannot-find-my-notion-database-3bkzhy/)

For further assistance, feel free to contact NoteForms support.

By following this guide, you should be able to resolve most database connection issues and ensure your forms work seamlessly with Notion.