The Page object contains the property values of a single Notion page.
All pages have a parent. If the parent is a database, the property values conform to the schema laid out database's properties. Otherwise, the only property value is the title
.
Page content is available as blocks. The content can be read using retrieve block children and appended using append block children.
Properties marked with an * are available to integrations with any capabilities. Other properties require read content capabilities in order to be returned from the Notion API. For more information on integration capabilities, see the capabilities guide.
All pages
Property | Type | Description | Example value |
---|---|---|---|
|
| Always |
|
|
| Unique identifier of the page. |
|
|
| Date and time when this page was created. Formatted as an ISO 8601 date time string. |
|
| User who created the page. |
| |
|
| Date and time when this page was updated. Formatted as an ISO 8601 date time string. |
|
| User who last edited the page. |
| |
|
| The archived status of the page. |
|
| File Object (only | Page icon. | |
| File object (only | Page cover image. | |
|
| Property values of this page. If If
| |
|
| The parent of this page. Can be a database, page, or workspace. Parent types are defined below. | |
|
| The URL of the Notion page. |
|
Database parent
The parent
property is an object containing the following keys:
Property | Type | Description | Example values |
---|---|---|---|
|
| Always |
|
|
| The ID of the database that this page belongs to. |
|
Page parent
The parent
property is an object containing the following keys:
Property | Type | Description | Example values |
---|---|---|---|
|
| Always |
|
|
| The ID of the page that this page belongs to. |
|
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 |
---|---|---|---|
|
| Always |
|
|
| Always |
|