Merge multipage table

Merged tables spanning multiple pages

Upstage Document Parse provides functionality to automatically detect and merge tables with identical structures that span across multiple pages. To enable this feature, set the merge_multipage_tables=true parameter in your request.

When tables are merged, the content is consolidated into the first table element among the connected tables. The subsequent table elements that were merged will have their content updated to reflect the merged result.

This feature is particularly useful in the following scenarios:

When long data tables span across multiple pages due to page breaks
When you need to maintain data continuity across page boundaries

merge_multipage_tables=false

{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Item</th><th>Price</th></tr><tr><td>Apple</td><td>$1</td></tr></table>",
    "markdown": "| Item | Price |\n|---|---|\n| Apple | $1 |",
    "text": "| Item | Price |\n|---|---|\n| Apple | $1 |"
  },
  "id": 4,
  "page": 1
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><td>Banana</td><td>$2</td></tr><tr><td>Orange</td><td>$3</td></tr></table>",
    "markdown": "| Banana | $2 |\n| Orange | $3 |",
    "text": "| Banana | $2 |\n| Orange | $3 |"
  },
  "id": 5,
  "page": 2
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Name</th><th>Age</th></tr><tr><td>John</td><td>25</td></tr></table>",
    "markdown": "| Name | Age |\n|---|---|\n| John | 25 |",
    "text": "| Name | Age |\n|---|---|\n| John | 25 |"
  },
  "id": 6,
  "page": 3
},

merge_multipage_tables=true

{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Item</th><th>Price</th></tr><tr><td>Apple</td><td>$1</td></tr><tr><td>Banana</td><td>$2</td></tr><tr><td>Orange</td><td>$3</td></tr></table>",
    "markdown": "| Item | Price |\n|---|---|\n| Apple | $1 |\n| Banana | $2 |\n| Orange | $3 |",
    "text": "| Item | Price |\n|---|---|\n| Apple | $1 |\n| Banana | $2 |\n| Orange | $3 |"
  },
  "id": 4,
  "page": 1
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Name</th><th>Age</th></tr><tr><td>John</td><td>25</td></tr></table>",
    "markdown": "| Name | Age |\n|---|---|\n| John | 25 |",
    "text": "| Name | Age |\n|---|---|\n| John | 25 |"
  },
  "id": 5,
  "page": 3
}

Merge multipage table

Merged tables spanning multiple pages

This feature is particularly useful in the following scenarios:

When long data tables span across multiple pages due to page breaks
When you need to maintain data continuity across page boundaries

merge_multipage_tables=false

{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Item</th><th>Price</th></tr><tr><td>Apple</td><td>$1</td></tr></table>",
    "markdown": "| Item | Price |\n|---|---|\n| Apple | $1 |",
    "text": "| Item | Price |\n|---|---|\n| Apple | $1 |"
  },
  "id": 4,
  "page": 1
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><td>Banana</td><td>$2</td></tr><tr><td>Orange</td><td>$3</td></tr></table>",
    "markdown": "| Banana | $2 |\n| Orange | $3 |",
    "text": "| Banana | $2 |\n| Orange | $3 |"
  },
  "id": 5,
  "page": 2
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Name</th><th>Age</th></tr><tr><td>John</td><td>25</td></tr></table>",
    "markdown": "| Name | Age |\n|---|---|\n| John | 25 |",
    "text": "| Name | Age |\n|---|---|\n| John | 25 |"
  },
  "id": 6,
  "page": 3
},

merge_multipage_tables=true

{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Item</th><th>Price</th></tr><tr><td>Apple</td><td>$1</td></tr><tr><td>Banana</td><td>$2</td></tr><tr><td>Orange</td><td>$3</td></tr></table>",
    "markdown": "| Item | Price |\n|---|---|\n| Apple | $1 |\n| Banana | $2 |\n| Orange | $3 |",
    "text": "| Item | Price |\n|---|---|\n| Apple | $1 |\n| Banana | $2 |\n| Orange | $3 |"
  },
  "id": 4,
  "page": 1
},
{
  "category": "table",
  "content": {
    "html": "<table><tr><th>Name</th><th>Age</th></tr><tr><td>John</td><td>25</td></tr></table>",
    "markdown": "| Name | Age |\n|---|---|\n| John | 25 |",
    "text": "| Name | Age |\n|---|---|\n| John | 25 |"
  },
  "id": 5,
  "page": 3
}

Merge multipage table

Merged tables spanning multiple pages

On this page

Merge multipage table

Merged tables spanning multiple pages

On this page