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.

FieldTypeDescriptionExample value
object*stringAlways "database"."database"
id*string (UUID)Unique identifier for the database."2f26ee68-df30-4251-aad4-8ddc420cba3d"
created_timestring (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_byPartial UserUser who created the database.{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
last_edited_timestring (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_byPartial UserUser who last edited the database.{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
titlearray of rich text objectsName 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 } ]
descriptionarray of rich text objectsDescription of the database as it appears in Notion.
See rich text object) for a breakdown of the properties.
iconFile Object or Emoji objectPage icon.
coverFile object (only type of "external" is supported currently)Page cover image.
properties*objectSchema of properties for the database as they appear in Notion.

key string
The name of the property as it appears in Notion.

value object
A Property object.
parentobjectInformation about the database's parent. See Parent object.{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }
urlstringThe URL of the Notion database."https://www.notion.so/668d797c76fa49349b05ad288df2d136"
archivedbooleanThe archived status of the database.false
is_inlinebooleanHas 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_urlstringThe 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.