---
title: "table add-columns"
slug: "table-add-columns"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/table-add-columns"
---

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

# table add-columns

This command creates a VAST database table.

## Usage

```plaintext
table create --name TABLE
             --schema-name SCHEMA
             --arrow-schema COLUMNS
             --database-name DATABASE 
            [--tenant-id TENANT]
```

## Required Parameters

| `--name TABLE` | Enter the name of the table where you want to add more columns. |
| --- | --- |
| `--schema-name SCHEMA` | Enter the name of the schema where the table resides. |
| `--arrow-schema COLUMNS` | Enter a comma-separated list of columns to be added. The columns are specified using the Arrow format, for example: `col1-int8,col2-string,col3-int8` > [!NOTE] > Note > > Complex data types are not supported on this command. To add a column with a complex data type, [use](/docs-5-5/docs/managing-tables#adding-columns-to-a-table-using-the-vast-web-ui) VAST Web UI. |
| `--database-name DATABASE` | Enter the name of the database where the table resides. |

## Options

| `--tenant-id TENANT` | Enter the ID of the tenant where the database resides If omitted, the default tenant is assumed. |
| --- | --- |

## Example

This example shows adding a column named `age` to table `cats`:

```plaintext
vcli: admin> table create --name cats --schema-name schema1 --arrow-schema age-int8 --database_name vastdb
```