You created a Notion button that should add a new page to a related database, but the page does not appear in the linked database or shows an error. This problem occurs because the button action is not properly configured to target the correct database relation or the database schema lacks the required relation property. This article explains the exact cause of the failure and provides a step-by-step fix to make your button add pages to the related database successfully.
Key Takeaways: Fixing a Button That Fails to Add Pages to a Related Database
- Relation property must exist in the target database: The database where the new page is created needs a relation property that links back to the source database.
- Button action must use Add page to and select the correct database: Choose the exact database and relation property from the button configuration menu.
- Rollup or formula properties are not required for the button to work: Only the relation property is mandatory; other property types can block the action if set to Required.
Why a Notion Button Fails to Add a Page to a Related Database
Notion buttons can create new pages in a database and link them to the current page through a relation property. When this fails, the root cause is almost always one of three things. First, the target database does not have a relation property that points back to the source database. Second, the button action is configured to create a page in the wrong target database or without specifying the relation property. Third, the target database has a required property that the button does not fill in, causing the page creation to fail silently.
The button action type called Add page to creates a new page in a selected database and automatically fills the relation property on the new page so it links to the current page. If that relation property is missing or misnamed, the button cannot establish the link. Notion does not show an error message in most cases; the button simply does not create the page, or the page appears without the relation link.
The Role of the Relation Property
A relation property in Notion connects two databases. For a button to link a new page back to the current page, the target database must contain a relation property that references the source database. For example, if you have a Projects database and a Tasks database, and you want a button on a project page to add a new task linked to that project, the Tasks database must have a relation property named Project or similar that points to the Projects database.
How the Button Action Works Internally
When you configure a button with the Add page to action, Notion prompts you to choose a database and then a relation property within that database. The relation property you select must already exist in the target database and must be linked to the source database. If you select a database but no relation property appears in the dropdown, the target database lacks the necessary relation property. The button will then create a page in the target database but without any relation link to the current page.
Steps to Fix the Button and Add Pages to a Related Database
- Open the source database and the target database
Identify the database that contains the current page where the button resides. This is the source database. Also open the database where you want the new page to be created. This is the target database. Write down the exact name of both databases. - Add a relation property to the target database
In the target database, click the + button in the table header to add a new property. Select Relation from the property type menu. In the relation configuration window, choose the source database as the related database. Give the relation property a clear name such as Related Project or Parent Task. Click Connect. - Verify the relation property appears in the target database
After creating the relation property, confirm it shows in the target database column header. The property should display a small chain link icon. Click on any existing page in the target database to see if the relation field shows a link to the source database. If it does, the relation is working correctly. - Navigate to the source database and find the button
Go back to the source database and locate the page that contains the button. Click the button to open its configuration panel. If the button is inside a database template, open the template editor instead. - Edit the button action to use Add page to
In the button configuration panel, click the existing action or click Add action. From the action type dropdown, select Add page to. A new field appears asking you to choose a database. Select the target database from the list. - Select the correct relation property
After selecting the target database, a second dropdown appears labeled Relation property. Click it and choose the relation property you created in step 2. If the relation property does not appear in this dropdown, the relation between the two databases is not correctly established. Return to step 2 and verify the relation points to the source database. - Set any required properties in the button
If the target database has any required properties such as Name, Status, or Date, the button must provide values for them. In the button configuration, click Edit properties under the action. A list of all properties in the target database appears. Set a default value for each required property. For example, set Status to Not Started or set Date to Today. Without these values, the button may not create the page. - Test the button
Click the button on the source page. A new page should appear in the target database. Open that new page and check the relation property field. It should show the source page name linked. If the page appears but the relation is empty, the relation property was not selected correctly in the button configuration. Repeat step 6.
If the Button Still Does Not Add Pages Correctly
Button Creates a Page But Relation Is Empty
This symptom means the button action selected the target database but did not properly assign the relation property. Open the button configuration and verify the Relation property dropdown shows the correct property. If the dropdown is blank or shows No relation properties available, the target database does not have a relation property pointing to the source database. Create the relation property in the target database first, then return to the button and select it.
Button Does Not Create Any Page
When the button does nothing after clicking, the most common cause is a required property in the target database that the button did not fill. Open the target database and check which properties have the toggle labeled Required enabled. In the button configuration, under Edit properties, set a default value for each required property. If the target database uses a formula or rollup property that is set as required, change that property to not required because buttons cannot generate formula or rollup values.
Button Works in One Direction But Not the Reverse
If you have two databases with a relation property on both sides, a button on a page in Database A can add a page to Database B only if Database B has a relation property pointing to Database A. The reverse requires a separate relation property in Database A pointing to Database B. Each button action uses only one relation property. You cannot reuse the same relation property for both directions if the button is on different databases.
Notion Button Add Page to vs Create Page in Database: Key Differences
| Item | Add page to | Create page in database |
|---|---|---|
| Purpose | Creates a new page and links it to the current page via a relation | Creates a new page in a database without linking to the current page |
| Relation property required | Yes, the target database must have a relation property pointing to the source database | No relation property needed |
| Button configuration options | Prompts to select both the target database and a relation property | Prompts only to select the target database |
| Use case | Adding a task to a project, adding a note to a meeting | Creating a new entry in a log or archive without linking |
With the relation property correctly set and the button action configured to Add page to, you can now reliably create linked pages across databases. Test the button after each configuration change to confirm it works. For advanced workflows, consider using Notion formulas to auto-fill additional properties on the new page by referencing the current page data through the relation link.