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.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"
}
Modified at 2023-04-28 06:52:26