> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://notion.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server.

# Simple table support

We have added support for simple tables in the API.

## Simple tables and simple table rows

Tables are parent blocks for table row children. They can only contain children of type `table_row`.

When creating a table block via the [Append block children](/reference/patch-block-children) endpoint, the `table` must have at least 1 `table_row` whose `cells` array has the same length as the `table_width`.

To fetch content for a `table`, fetch the the `table_row` children via [Retrieve block children](/reference/get-block-children). The `table` block itself only contains formatting data, no content.

Table block example:

**`JSON`**

```json JSON
{
	"type": "table",
	"table": {
		"table_width": 3,
		"has_column_header": false,
		"has_row_header": false
	}
}
```
Table row block example:

**`JSON`**

```json JSON
{
  "type": "table_row",
  "table_row": {
    "cells": [
      [
        {
          "type": "text",
          "text": {
            "content": "column 1 content",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "column 1 content",
          "href": null
        }
      ],
      [
        {
          "type": "text",
          "text": {
            "content": "column 2 content",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "column 2 content",
          "href": null
        }
      ],
      [
        {
          "type": "text",
          "text": {
            "content": "column 3 content",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "column 3 content",
          "href": null
        }
      ]
    ]
  }
}
```
For more details, see the [Block object](/reference/block) docs.