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"
}