Pages, databases, and blocks are either located inside other pages, databases, and blocks, or are located at the top level of a workspace. This location is known as the "parent". Parent information is represented by a consistent parent
object throughout the API.
Parenting rules:
- Pages can be parented by other pages, databases, blocks, or by the whole workspace.
- Blocks can be parented by pages, databases, or blocks.
- Databases can be parented by pages, blocks, or by the whole workspace.
Database parent
Property | Type | Description | Example values |
---|---|---|---|
type | string | Always "database_id" . | "database_id" |
database_id | string (UUIDv4) | The ID of the database that this page belongs to. | "b8595b75-abd1-4cad-8dfe-f935a8ef57cb" |
{
"type": "database_id",
"database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
}
Page parent
Property | Type | Description | Example values |
---|---|---|---|
type | string | Always "page_id" . | "page_id" |
page_id | string (UUIDv4) | The ID of the page that this page belongs to. | "59833787-2cf9-4fdf-8782-e53db20768a5" |
{
"type": "page_id",
"page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
}
Workspace parent
A page with a workspace parent is a top-level page within a Notion workspace. The parent
property is an object containing the following keys:
Property | Type | Description | Example values |
---|---|---|---|
type | type | Always "workspace" . | "workspace" |
workspace | boolean | Always true . | true |
{
"type": "workspace",
"workspace": true
}
Block parent
A page may have a block parent if it is created inline in a chunk of text, or is located beneath another block like a toggle or bullet block. The parent
property is an object containing the following keys:
Property | Type | Description | Example values |
---|---|---|---|
type | type | Always "block_id" . | "block_id" |
block_id | string (UUIDv4) | The ID of the page that this page belongs to. | "ea29285f-7282-4b00-b80c-32bdbab50261" |
{
"type": "block_id",
"block_id": "7d50a184-5bbe-4d90-8f29-6bec57ed817b"
}