# TabItem

One tab (sheet) of a spreadsheet.

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `id` | integer, nullable | no | Numeric Google sheetId (Google Sheets only; null for Excel/CSV, whose tabs are identified by `name`). Pass as `tab_id` when creating a dashboard element. |  |
| `name` | string, nullable | no | Tab title |  |
| `index` | integer, nullable | no | Zero-based position |  |
| `rows` | integer, nullable | no | Grid row count |  |
| `cols` | integer, nullable | no | Grid column count |  |
| `hidden` | boolean | no | True when the tab is hidden in the UI | default: `false` |
| `type` | string, nullable | no | Provider sheet type, e.g. GRID |  |
| `columns` | array of [ColumnItem](https://dev-api.sheetgo.com/rest/reference/models/ColumnItem.md), nullable | no | Letter → header map of this tab, when `include=columns` read it. Null when not requested, or not read (see `columns_truncated`). |  |

## Used by

- [GET /rest/beta/files/{provider}/{file_id}/structure](https://dev-api.sheetgo.com/rest/reference/files.md#get-rest-beta-files-provider-file-id-structure)
- [SpreadsheetStructure](https://dev-api.sheetgo.com/rest/reference/models/SpreadsheetStructure.md)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.