# tables.listPresets

> List built-in table style presets that tables.applyPreset accepts: 105 Word table styles (Table Grid, Grid Table Light, Plain Table 1-5, and the Grid Table and List Table designs 1-7 with neutral and Accent 1-6 variants) plus the four SuperDoc convenience presets. Filter by source ("word" or "superdoc"), group ("plain", "grid", "list", "convenience"), or a query matching IDs, names, or appearance terms (shading, banded rows, horizontal borders). Pages contain up to limit items within the tool payload budget: follow nextOffset until null. Word appearance describes declared header, first body-row band, and primary borders, conditional on headerRow/bandedRows options. Missing properties are inherited, not white or border-free. Document Normal Table, other enabled regions, and direct formatting can override these cues. Resolve themeColor through styles.getTheme: resolve every role through colorSchemeMapping first (text1/text2/background1/background2 use t1/t2/bg1/bg2 keys); unmapped accents use their same-named colorScheme slot. Apply OOXML hex tint/shade modifiers; a neutral accent:null may still use theme colors. Convenience appearance is null. This fixed catalogue does not read or change the document; tables.getStyles lists installed styles.



- Member path: `doc.tables.listPresets(…)`
- Mutates document: no
- Idempotency: `idempotent`
- Supports tracked mode: no
- Supports dry run: no

## Expected result

Returns a TablesListPresetsOutput page with items (id, name, source, group, accent, appearance), the exact filtered total, the page offset, and nextOffset (null when no more matches remain).

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {},
  "type": "object",
  "properties": {
    "source": {
      "enum": [
        "word",
        "superdoc"
      ]
    },
    "group": {
      "enum": [
        "plain",
        "grid",
        "list",
        "convenience"
      ]
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {},
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "source": {
            "enum": [
              "word",
              "superdoc"
            ]
          },
          "group": {
            "enum": [
              "plain",
              "grid",
              "list",
              "convenience"
            ]
          },
          "accent": {
            "oneOf": [
              {
                "type": "integer",
                "minimum": 1,
                "maximum": 6
              },
              {
                "type": "null"
              }
            ]
          },
          "appearance": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "baseFill": {
                    "type": "object",
                    "properties": {
                      "themeColor": {
                        "type": "string",
                        "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                      },
                      "rgb": {
                        "type": "string",
                        "pattern": "^[0-9A-F]{6}$"
                      },
                      "tint": {
                        "type": "string",
                        "pattern": "^[0-9A-Fa-f]{2}$",
                        "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                      },
                      "shade": {
                        "type": "string",
                        "pattern": "^[0-9A-Fa-f]{2}$",
                        "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                      }
                    },
                    "additionalProperties": false
                  },
                  "header": {
                    "type": "object",
                    "properties": {
                      "treatment": {
                        "type": "array",
                        "items": {
                          "enum": [
                            "shading",
                            "bold",
                            "borders"
                          ]
                        }
                      },
                      "fill": {
                        "type": "object",
                        "properties": {
                          "themeColor": {
                            "type": "string",
                            "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                          },
                          "rgb": {
                            "type": "string",
                            "pattern": "^[0-9A-F]{6}$"
                          },
                          "tint": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                          },
                          "shade": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                          }
                        },
                        "additionalProperties": false
                      },
                      "textColor": {
                        "type": "object",
                        "properties": {
                          "themeColor": {
                            "type": "string",
                            "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                          },
                          "rgb": {
                            "type": "string",
                            "pattern": "^[0-9A-F]{6}$"
                          },
                          "tint": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                          },
                          "shade": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false,
                    "required": [
                      "treatment"
                    ]
                  },
                  "bandedRows": {
                    "type": "object",
                    "properties": {
                      "effect": {
                        "enum": [
                          "none",
                          "shading",
                          "borders",
                          "shadingAndBorders"
                        ]
                      },
                      "fill": {
                        "type": "object",
                        "properties": {
                          "themeColor": {
                            "type": "string",
                            "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                          },
                          "rgb": {
                            "type": "string",
                            "pattern": "^[0-9A-F]{6}$"
                          },
                          "tint": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                          },
                          "shade": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                          }
                        },
                        "additionalProperties": false
                      },
                      "borderColor": {
                        "type": "object",
                        "properties": {
                          "themeColor": {
                            "type": "string",
                            "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                          },
                          "rgb": {
                            "type": "string",
                            "pattern": "^[0-9A-F]{6}$"
                          },
                          "tint": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                          },
                          "shade": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false,
                    "required": [
                      "effect"
                    ]
                  },
                  "borders": {
                    "type": "object",
                    "properties": {
                      "layout": {
                        "enum": [
                          "none",
                          "horizontal",
                          "outer",
                          "outerAndHorizontal",
                          "grid"
                        ]
                      },
                      "color": {
                        "type": "object",
                        "properties": {
                          "themeColor": {
                            "type": "string",
                            "description": "OOXML theme role. Resolve with styles.getTheme; never assume an accent has a fixed RGB."
                          },
                          "rgb": {
                            "type": "string",
                            "pattern": "^[0-9A-F]{6}$"
                          },
                          "tint": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme tint hex byte; 00 is white and FF leaves the theme color unchanged."
                          },
                          "shade": {
                            "type": "string",
                            "pattern": "^[0-9A-Fa-f]{2}$",
                            "description": "OOXML theme shade hex byte; 00 is black and FF leaves the theme color unchanged."
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false,
                    "required": [
                      "layout"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "header",
                  "bandedRows",
                  "borders"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "name",
          "source",
          "group",
          "accent",
          "appearance"
        ]
      }
    },
    "total": {
      "type": "integer",
      "minimum": 0
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "nextOffset": {
      "oneOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "items",
    "total",
    "offset",
    "nextOffset"
  ]
}
```

## Pre-apply throws

- `INVALID_INPUT`

## Non-applied receipt codes

- None

