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

PropertyTypeDescriptionExample values
typestringAlways "database_id"."database_id"
database_idstring (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

PropertyTypeDescriptionExample values
typestringAlways "page_id"."page_id"
page_idstring (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:

PropertyTypeDescriptionExample values
typetypeAlways "workspace"."workspace"
workspacebooleanAlways 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:

PropertyTypeDescriptionExample values
typetypeAlways "block_id"."block_id"
block_idstring (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"
}