> ## 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](https://developers.notion.com/reference/data-source.md). 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](https://developers.notion.com/reference/data-source.md) object was introduced, and includes the `properties` that used to exist here at the database level.
>
> ![One database contains two data sources. Each data source has its own rows, shown as pages.](https://mintcdn.com/notion-demo/Muj7K3D7I6gj-QAA/images/reference/6dc5c7eccb432e908290e2642c84579936d55ee79c6cd60a5b0807e70cdeb55a-image.png?fit=max\&auto=format\&n=Muj7K3D7I6gj-QAA\&q=85\&s=732ada865d8d25def0ba61090c6e9f2e)
>
> Database structure since API version 2025-09-03
>
> After [upgrading your API](https://developers.notion.com/guides/get-started/upgrade-guide-2025-09-03.md) connection to `2025-09-03`, the new database object shape is displayed, including an array of child `data_sources` but **not** the data source `properties`.

| 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`. [Retrieve a database](https://developers.notion.com/reference/retrieve-database.md) may also include optional [sync metadata and health](https://developers.notion.com/reference/data-source.md#sync-metadata) for each readable source.   Use [Retrieve a data source](https://developers.notion.com/reference/retrieve-a-data-source.md) 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](https://developers.notion.com/reference/user.md) | 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](https://developers.notion.com/reference/user.md) | User who last edited the database. | `{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}` |
| `title` | array of [rich text objects](https://developers.notion.com/reference/rich-text.md) | Name of the database as it appears in Notion. See [rich text object](https://developers.notion.com/reference/rich-text.md)) 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](https://developers.notion.com/reference/rich-text.md) | Description of the database as it appears in Notion. See [rich text object](https://developers.notion.com/reference/rich-text.md)) for a breakdown of the properties. | |
| `icon` | [Emoji](https://developers.notion.com/reference/emoji-and-icon.md#emoji), [Icon](https://developers.notion.com/reference/emoji-and-icon.md#icon), [Custom emoji](https://developers.notion.com/reference/emoji-and-icon.md#custom-emoji), or [File](https://developers.notion.com/reference/file-object.md) | Database icon. See [Icon](https://developers.notion.com/reference/emoji-and-icon.md) for all supported types. An icon set in the Notion UI is returned by both [Retrieve a database](https://developers.notion.com/reference/retrieve-a-database.md) and [Retrieve a data source](https://developers.notion.com/reference/retrieve-a-data-source.md). | |
| `cover` | [File object](https://developers.notion.com/reference/file-object.md) | Page cover image. | |
| `parent` | `object` | Information about the database's parent. See [Parent object](https://developers.notion.com/reference/parent-object.md). | `{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }` |
| `url` | `string` | The URL of the Notion database. | `"https://app.notion.com/p/668d797c76fa49349b05ad288df2d136"` |
| `archived` | `boolean` | **Deprecated.** Use `in_trash` instead. In API versions before `2026-03-11`, this is an alias for `in_trash` and always returns the same value. Version `2026-03-11` removed `archived` from requests and responses. | `false` |
| `in_trash` | `boolean` | Whether the database has been trashed. | `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` |
| `database_type` | `string` or `null` | The type of typed database, such as `tasks`, `projects`, or `skills`. `null` for a regular database. | `"skills"` |
| `show_data_source_title` | `boolean` | Whether the data source title is shown above the database's views. This is the **Show data source title** setting in the Notion app. Full-page databases with one data source never show this title. Set it with [Create a database](https://developers.notion.com/reference/create-database.md), [Update a database](https://developers.notion.com/reference/update-database.md), or `create_database` on [Create a view](https://developers.notion.com/reference/create-view.md). | `true` |
| `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**

> [card] [Data source](https://developers.notion.com/reference/data-source.md)

> [card] [Data source properties](https://developers.notion.com/reference/property-object.md)

> [card] [Page](https://developers.notion.com/reference/page.md)
