# Source: https://developers.notion.com/reference/data-source.md

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.notion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/reference/page) are the items (or children) in a data source. [Page property values](/reference/page#property-value-object) must conform to the [property objects](/reference/property-object) laid out in the parent data source object.

<Frame caption="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.">
  <img src="https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=732ada865d8d25def0ba61090c6e9f2e" data-og-width="443" width="443" data-og-height="302" height="302" data-path="images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=280&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=8d33e61be4213e2a024bcbe4b01a3bd1 280w, https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=560&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=3353aea11c132efb30d71bf0fd9839c9 560w, https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=840&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=7d0a175fcd59c54ae57a9c342dde1487 840w, https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=1100&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=e88f2799abfa21ad2e6154e9dc963e1d 1100w, https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=1650&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=7043f683e79ba9ec7144137434c93013 1650w, https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?w=2500&fit=max&auto=format&n=Muj7K3D7I6gj-QAA&q=85&s=cc1ec88f460a1ea3e9c304142bdc3bf3 2500w" />
</Frame>

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

* [Create a data source](/reference/create-a-data-source): add an additional data source for an existing [Database](/reference/database)
* [Update a data source](/reference/update-a-data-source): update attributes, such as the `properties`, of a data source
* [Retrieve a data source](/reference/retrieve-a-data-source)
* [Query a data source](/reference/query-a-data-source)

## Object fields

<Note>
  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](/reference/capabilities).
</Note>

| Field              | Type                                                                             | Description                                                                                                                                                                                                               | Example value                                                                                                                                                                                                                                                                             |
| :----------------- | :------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`\*         | `string`                                                                         | Always `"data_source"`.                                                                                                                                                                                                   | `"data_source"`                                                                                                                                                                                                                                                                           |
| `id`\*             | `string` (UUID)                                                                  | Unique identifier for the data source.                                                                                                                                                                                    | `"2f26ee68-df30-4251-aad4-8ddc420cba3d"`                                                                                                                                                                                                                                                  |
| `properties`\*     | `object`                                                                         | Schema of properties for the data source as they appear in Notion. <br /><br />`key` string The name of the property as it appears in Notion. <br /><br />`value` object A [Property object](/reference/property-object). |                                                                                                                                                                                                                                                                                           |
| `parent`           | `object`                                                                         | Information about the data source's parent database. See [Parent object](/reference/parent-object).                                                                                                                       | `{"type": "database_id", "database_id": "842a0286-cef0-46a8-abba-eac4c8ca644e"}`                                                                                                                                                                                                          |
| `database_parent`  | `object`                                                                         | Information about the database's parent (in other words, the the data source's grandparent). See [Parent object](/reference/parent-object) .                                                                              | `{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }`                                                                                                                                                                                                                |
| `created_time`     | `string` ([ISO 8601 date and time](https://en.wikipedia.org/wiki/ISO_8601))      | Date and time when this data source was created. Formatted as an [ISO 8601 date time](https://en.wikipedia.org/wiki/ISO_8601) string.                                                                                     | `"2020-03-17T19:10:04.968Z"`                                                                                                                                                                                                                                                              |
| `created_by`       | [Partial User](/reference/user)                                                  | User who created the data source.                                                                                                                                                                                         | `{"object": "user", "id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}`                                                                                                                                                                                                                        |
| `last_edited_time` | `string` ([ISO 8601 date and time](https://en.wikipedia.org/wiki/ISO_8601))      | Date and time when this data source was updated. Formatted as an [ISO 8601 date time](https://en.wikipedia.org/wiki/ISO_8601) string.                                                                                     | `"2020-03-17T21:49:37.913Z"`                                                                                                                                                                                                                                                              |
| `last_edited_by`   | [Partial User](/reference/user)                                                  | User who last edited the data source.                                                                                                                                                                                     | `{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}`                                                                                                                                                                                                                         |
| `title`            | array of [rich text objects](/reference/rich-text)                               | Name of the data source as it appears in Notion. See [rich text object](/reference/rich-text)) 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 } ]` |
| `description`      | array of [rich text objects](/reference/rich-text)                               | Description of the data source as it appears in Notion. See [rich text object](/reference/rich-text)) for a breakdown of the properties.                                                                                  |                                                                                                                                                                                                                                                                                           |
| `icon`             | [File Object](/reference/file-object) or [Emoji object](/reference/emoji-object) | Data source icon.                                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                           |
| `archived`         | `boolean`                                                                        | The archived status of the data source.                                                                                                                                                                                   | `false`                                                                                                                                                                                                                                                                                   |
| `in_trash`         | `boolean`                                                                        | Whether the data source has been deleted.                                                                                                                                                                                 | `false`                                                                                                                                                                                                                                                                                   |

<Warning>
  **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.
</Warning>