Data source

Learn more about Notion's data source object.

Data sources are the individual tables of data that live under a Notion database. Pages are the items (or children) in a data source. Page property values must conform to the property objects laid out in the parent data source object.

Diagram of the new Notion API data model: databases parent one or more data sources, each of which parents zero or more pages.

Diagram of the new Notion API data model.
A database is a parent of one or more data sources, each of which parents zero or more pages.
Previously, databases could only have one data source, so the concepts were combined in the API until 2025.

As of API version 2025-09-03, there's a suite of APIs for managing data sources:

Object fields

📘

Properties marked with an asterisk (*) 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 "data_source"."data_source"
id*string (UUID)Unique identifier for the data source."2f26ee68-df30-4251-aad4-8ddc420cba3d"
properties*objectSchema of properties for the data source 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 data source's parent database. See Parent object.{"type": "database_id", "database_id": "842a0286-cef0-46a8-abba-eac4c8ca644e"}
database_parentobjectInformation about the database's parent (in other words, the the data source's grandparent). See Parent object .{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }
created_timestring (ISO 8601 date and time)Date and time when this data source was created. Formatted as an ISO 8601 date time string."2020-03-17T19:10:04.968Z"
created_byPartial UserUser who created the data source.{"object": "user", "id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
last_edited_timestring (ISO 8601 date and time)Date and time when this data source was updated. Formatted as an ISO 8601 date time string."2020-03-17T21:49:37.913Z"
last_edited_byPartial UserUser who last edited the data source.{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
titlearray of rich text objectsName of the data source as it appears in Notion.
See rich text object) for a breakdown of the properties.
[ { "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 data source as it appears in Notion.
See rich text object) for a breakdown of the properties.
iconFile Object or Emoji objectData source icon.
archivedbooleanThe archived status of the data source.false
in_trashbooleanWhether the data source has been deleted.false

🚧

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.