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

# Tables operations

> Tables operation reference from the canonical Document API contract.

[Back to full reference](https://docs.superdoc.dev/document-api/reference/index.md)

Table structure, layout, styling, and cell operations.

> [!TIP]
>
> For non-destructive table-targeted mutations, reuse `result.table.nodeId` from the previous success result instead of re-running `find()`. Cell-targeted border/shading calls may still return a `tableCell` address.

| Operation | Member path | Mutates | Idempotency | Tracked | Dry run |
| - | - | - | - | - | - |
| [`tables.convertFromText`](https://docs.superdoc.dev/document-api/reference/tables/convert-from-text) | `tables.convertFromText` | Yes | `non-idempotent` | No | Yes |
| [`tables.delete`](https://docs.superdoc.dev/document-api/reference/tables/delete) | `tables.delete` | Yes | `conditional` | Yes | Yes |
| [`tables.clearContents`](https://docs.superdoc.dev/document-api/reference/tables/clear-contents) | `tables.clearContents` | Yes | `conditional` | No | Yes |
| [`tables.move`](https://docs.superdoc.dev/document-api/reference/tables/move) | `tables.move` | Yes | `conditional` | No | Yes |
| [`tables.split`](https://docs.superdoc.dev/document-api/reference/tables/split) | `tables.split` | Yes | `non-idempotent` | No | Yes |
| [`tables.convertToText`](https://docs.superdoc.dev/document-api/reference/tables/convert-to-text) | `tables.convertToText` | Yes | `conditional` | No | Yes |
| [`tables.setLayout`](https://docs.superdoc.dev/document-api/reference/tables/set-layout) | `tables.setLayout` | Yes | `idempotent` | No | Yes |
| [`tables.insertRow`](https://docs.superdoc.dev/document-api/reference/tables/insert-row) | `tables.insertRow` | Yes | `non-idempotent` | Yes | Yes |
| [`tables.deleteRow`](https://docs.superdoc.dev/document-api/reference/tables/delete-row) | `tables.deleteRow` | Yes | `conditional` | Yes | Yes |
| [`tables.setRowHeight`](https://docs.superdoc.dev/document-api/reference/tables/set-row-height) | `tables.setRowHeight` | Yes | `idempotent` | No | Yes |
| [`tables.distributeRows`](https://docs.superdoc.dev/document-api/reference/tables/distribute-rows) | `tables.distributeRows` | Yes | `conditional` | No | Yes |
| [`tables.setRowOptions`](https://docs.superdoc.dev/document-api/reference/tables/set-row-options) | `tables.setRowOptions` | Yes | `idempotent` | No | Yes |
| [`tables.insertColumn`](https://docs.superdoc.dev/document-api/reference/tables/insert-column) | `tables.insertColumn` | Yes | `non-idempotent` | Yes | Yes |
| [`tables.deleteColumn`](https://docs.superdoc.dev/document-api/reference/tables/delete-column) | `tables.deleteColumn` | Yes | `conditional` | Yes | Yes |
| [`tables.setColumnWidth`](https://docs.superdoc.dev/document-api/reference/tables/set-column-width) | `tables.setColumnWidth` | Yes | `idempotent` | No | Yes |
| [`tables.distributeColumns`](https://docs.superdoc.dev/document-api/reference/tables/distribute-columns) | `tables.distributeColumns` | Yes | `conditional` | No | Yes |
| [`tables.insertCell`](https://docs.superdoc.dev/document-api/reference/tables/insert-cell) | `tables.insertCell` | Yes | `non-idempotent` | No | Yes |
| [`tables.deleteCell`](https://docs.superdoc.dev/document-api/reference/tables/delete-cell) | `tables.deleteCell` | Yes | `conditional` | No | Yes |
| [`tables.mergeCells`](https://docs.superdoc.dev/document-api/reference/tables/merge-cells) | `tables.mergeCells` | Yes | `conditional` | No | Yes |
| [`tables.unmergeCells`](https://docs.superdoc.dev/document-api/reference/tables/unmerge-cells) | `tables.unmergeCells` | Yes | `conditional` | No | Yes |
| [`tables.splitCell`](https://docs.superdoc.dev/document-api/reference/tables/split-cell) | `tables.splitCell` | Yes | `non-idempotent` | No | Yes |
| [`tables.setCellProperties`](https://docs.superdoc.dev/document-api/reference/tables/set-cell-properties) | `tables.setCellProperties` | Yes | `idempotent` | No | Yes |
| [`tables.setCellText`](https://docs.superdoc.dev/document-api/reference/tables/set-cell-text) | `tables.setCellText` | Yes | `idempotent` | No | Yes |
| [`tables.sort`](https://docs.superdoc.dev/document-api/reference/tables/sort) | `tables.sort` | Yes | `non-idempotent` | No | Yes |
| [`tables.setAltText`](https://docs.superdoc.dev/document-api/reference/tables/set-alt-text) | `tables.setAltText` | Yes | `idempotent` | No | Yes |
| [`tables.setStyle`](https://docs.superdoc.dev/document-api/reference/tables/set-style) | `tables.setStyle` | Yes | `idempotent` | No | Yes |
| [`tables.clearStyle`](https://docs.superdoc.dev/document-api/reference/tables/clear-style) | `tables.clearStyle` | Yes | `conditional` | No | Yes |
| [`tables.setStyleOption`](https://docs.superdoc.dev/document-api/reference/tables/set-style-option) | `tables.setStyleOption` | Yes | `idempotent` | No | Yes |
| [`tables.setBorder`](https://docs.superdoc.dev/document-api/reference/tables/set-border) | `tables.setBorder` | Yes | `idempotent` | No | Yes |
| [`tables.clearBorder`](https://docs.superdoc.dev/document-api/reference/tables/clear-border) | `tables.clearBorder` | Yes | `conditional` | No | Yes |
| [`tables.applyBorderPreset`](https://docs.superdoc.dev/document-api/reference/tables/apply-border-preset) | `tables.applyBorderPreset` | Yes | `idempotent` | No | Yes |
| [`tables.setShading`](https://docs.superdoc.dev/document-api/reference/tables/set-shading) | `tables.setShading` | Yes | `idempotent` | No | Yes |
| [`tables.clearShading`](https://docs.superdoc.dev/document-api/reference/tables/clear-shading) | `tables.clearShading` | Yes | `conditional` | No | Yes |
| [`tables.setTablePadding`](https://docs.superdoc.dev/document-api/reference/tables/set-table-padding) | `tables.setTablePadding` | Yes | `idempotent` | No | Yes |
| [`tables.setCellPadding`](https://docs.superdoc.dev/document-api/reference/tables/set-cell-padding) | `tables.setCellPadding` | Yes | `idempotent` | No | Yes |
| [`tables.setCellSpacing`](https://docs.superdoc.dev/document-api/reference/tables/set-cell-spacing) | `tables.setCellSpacing` | Yes | `idempotent` | No | Yes |
| [`tables.clearCellSpacing`](https://docs.superdoc.dev/document-api/reference/tables/clear-cell-spacing) | `tables.clearCellSpacing` | Yes | `conditional` | No | Yes |
| [`tables.applyStyle`](https://docs.superdoc.dev/document-api/reference/tables/apply-style) | `tables.applyStyle` | Yes | `conditional` | No | Yes |
| [`tables.setBorders`](https://docs.superdoc.dev/document-api/reference/tables/set-borders) | `tables.setBorders` | Yes | `idempotent` | No | Yes |
| [`tables.setTableOptions`](https://docs.superdoc.dev/document-api/reference/tables/set-table-options) | `tables.setTableOptions` | Yes | `conditional` | No | Yes |
| [`tables.applyPreset`](https://docs.superdoc.dev/document-api/reference/tables/apply-preset) | `tables.applyPreset` | Yes | `idempotent` | No | Yes |
| [`tables.get`](https://docs.superdoc.dev/document-api/reference/tables/get) | `tables.get` | No | `idempotent` | No | No |
| [`tables.getCells`](https://docs.superdoc.dev/document-api/reference/tables/get-cells) | `tables.getCells` | No | `idempotent` | No | No |
| [`tables.getProperties`](https://docs.superdoc.dev/document-api/reference/tables/get-properties) | `tables.getProperties` | No | `idempotent` | No | No |
| [`tables.getStyles`](https://docs.superdoc.dev/document-api/reference/tables/get-styles) | `tables.getStyles` | No | `idempotent` | No | No |
| [`tables.setDefaultStyle`](https://docs.superdoc.dev/document-api/reference/tables/set-default-style) | `tables.setDefaultStyle` | Yes | `idempotent` | No | Yes |
| [`tables.clearDefaultStyle`](https://docs.superdoc.dev/document-api/reference/tables/clear-default-style) | `tables.clearDefaultStyle` | Yes | `conditional` | No | Yes |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.