# Source: https://developers.notion.com/reference/database.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.

# Database

> Learn more about Notion's database object.

A **database** is an object that contains one or more [data sources](/reference/create-a-data-source). Databases can either be displayed inline in the parent page (`is_inline: true`) or as a full page (`is_inline: false`). The properties (schema) of each data source under a database can be maintained independently, and each data source has its own set of rows (pages).

Individual data sources don't have permissions settings, so the set of Notion users and bots that have access to data source children is managed through **databases**.

## Object fields

<Note>
  **Changed as of 2025-09-03**

  In September 2025, the [Data source](/reference/data-source) object was introduced, and includes the `properties` that used to exist here at the database level.

  <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>

  After [upgrading your API](/guides/get-started/upgrade-guide-2025-09-03) integration to `2025-09-03`, the new database object shape is displayed, including an array of child `data_sources` but **not** the data source `properties`.
</Note>

| Field              | Type                                                                             | Description                                                                                                                                                                                                                          | Example value                                                                                                                                                                                                                                                                                      |
| :----------------- | :------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`           | `string`                                                                         | Always `"database"`.                                                                                                                                                                                                                 | `"database"`                                                                                                                                                                                                                                                                                       |
| `id`               | `string` (UUID)                                                                  | Unique identifier for the database.                                                                                                                                                                                                  | `"2f26ee68-df30-4251-aad4-8ddc420cba3d"`                                                                                                                                                                                                                                                           |
| `data_sources`     | array of data source objects                                                     | List of child data sources, each of which is a JSON object with an `id` and `name`. <br /><br /> Use [Retrieve a data source](/reference/retrieve-a-data-source) to get more details on the data source, including its `properties`. | `[{"id": "c174b72c-d782-432f-8dc0-b647e1c96df6", "name": "Tasks data source"}]`                                                                                                                                                                                                                    |
| `created_time`     | `string` ([ISO 8601 date and time](https://en.wikipedia.org/wiki/ISO_8601))      | Date and time when this database 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 database.                                                                                                                                                                                                       | `{"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 database 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 database.                                                                                                                                                                                                   | `{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}`                                                                                                                                                                                                                                  |
| `title`            | array of [rich text objects](/reference/rich-text)                               | Name of the database as it appears in Notion. See [rich text object](/reference/rich-text)) 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](/reference/rich-text)                               | Description of the database 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) | Page icon.                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                    |
| `cover`            | [File object](/reference/file-object)                                            | Page cover image.                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                    |
| `parent`           | `object`                                                                         | Information about the database's parent. See [Parent object](/reference/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`                                                                                                                                                                                                                            |

**What’s Next**

<CardGroup>
  <Card title="Data source" href="/reference/data-source" icon="angles-right" horizontal color="#0076d7" />

  <Card title="Data source properties" href="/reference/property-object" icon="angles-right" horizontal color="#0076d7" />

  <Card title="Page" href="/reference/page" icon="angles-right" horizontal color="#0076d7" />
</CardGroup>