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

> ## 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.

# schema create

This command creates a VAST database schema.

## Usage

```plaintext
schema create --name SCHEMA
              --database-name DATABASE 
             [--tenant-id TENANT]    
```

## Required Parameters

| `--name SCHEMA` | Enter a name for the schema being created. The name must meet the requirements for S3 object names. |
| --- | --- |
| `--database-name DATABASE` | Enter the name of the database where the schema is created. A database can contain one or more schemas. The database name must meet the requirements for S3 bucket names. |

## 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 schema named `schema1` to database `vastdb`:

```plaintext
vcli: admin> schema create --name schema1 --database-name vastdb
```