Database objects describe the property schema of a database in Notion. Pages are the items (or children) in a database. Page property values must conform to the property objects laid out in the parent database object.
All databases
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.
| Field | Type | Description | Example value |
|---|---|---|---|
object* | string | Always "database". | "database" |
id* | string (UUID) | Unique identifier for the database. | "2f26ee68-df30-4251-aad4-8ddc420cba3d" |
created_time | string (ISO 8601 date and time) | Date and time when this database was created. Formatted as an ISO 8601 date time string. | "2020-03-17T19:10:04.968Z" |
created_by | Partial User | User who created the database. | {"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"} |
last_edited_time | string (ISO 8601 date and time) | Date and time when this database was updated. Formatted as an ISO 8601 date time string. | "2020-03-17T21:49:37.913Z" |
last_edited_by | Partial User | User who last edited the database. | {"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"} |
title | array of rich text objects | Name of the database as it appears in Notion. See rich text object) for a breakdown of the properties. | "title": [ { "type": "text", "text": { "content": "Can I create a URL property", "link": null }, "annotations": { "bold": false, "italic": false, "strikethrough": false, "underline": false, "code": false, "color": "default" }, "plain_text": "Can I create a URL property", "href": null } ] |
description | array of rich text objects | Description of the database as it appears in Notion. See rich text object) for a breakdown of the properties. | |
icon | File Object or Emoji object | Page icon. | |
cover | File object (only type of "external" is supported currently) | Page cover image. | |
properties* | object | Schema of properties for the database as they appear in Notion.key stringThe name of the property as it appears in Notion. value objectA Property object. | |
parent | object | Information about the database's parent. See Parent object. | { "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" } |
url | string | The URL of the Notion database. | "https://www.notion.so/668d797c76fa49349b05ad288df2d136" |
archived | boolean | The archived status of the database. | false |
in_trash | boolean | Whether the database has been deleted. | false |
is_inline | boolean | Has the value true if the database appears in the page as an inline block. Otherwise has the value false if the database appears as a child page. | false |
public_url | string | The public page URL if the page has been published to the web. Otherwise, null. | "https://jm-testing.notion.site/p1-6df2c07bfc6b4c46815ad205d132e22d"1 |
Maximum schema size recommendation
Notion recommends a maximum schema size of 50KB. Updates to database schemas that are too large will be blocked to help maintain database performance.