# format (Prisma CLI v7) (/docs/cli/v7/format)

> For the complete Prisma documentation index, see [llms.txt](https://www.prisma.io/docs/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Format and validate your Prisma schema file with consistent structure

Location: CLI > v7 > format

The `prisma format` command formats your Prisma schema file. It validates, formats, and persists the schema.

## Usage [#usage]

```bash
prisma format [options]
```

## Options [#options]

| Option         | Description                            |
| -------------- | -------------------------------------- |
| `-h`, `--help` | Display help message                   |
| `--config`     | Custom path to your Prisma config file |
| `--schema`     | Custom path to your Prisma schema      |

## Examples [#examples]

### Format the default schema [#format-the-default-schema]

  

#### bun

```bash
bunx prisma format
```

#### pnpm

```bash
pnpm prisma format
```

#### yarn

```bash
yarn prisma format
```

#### npm

```bash
npx prisma format
```

Output on success:

```text
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Formatted prisma/schema.prisma in 116ms
```

### Format a specific schema [#format-a-specific-schema]

  

#### bun

```bash
bunx prisma format --schema=./alternative/schema.prisma
```

#### pnpm

```bash
pnpm prisma format --schema=./alternative/schema.prisma
```

#### yarn

```bash
yarn prisma format --schema=./alternative/schema.prisma
```

#### npm

```bash
npx prisma format --schema=./alternative/schema.prisma
```

## Error output [#error-output]

If the schema has validation errors, formatting will fail:

```text
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Error: Schema validation error - Error (query-engine-node-api library)
Error code: P1012
error: The preview feature "unknownFeatureFlag" is not known. Expected one of: [...]
  schema.prisma:3
   |
 2 |     provider        = "prisma-client"
 3 |     previewFeatures = ["unknownFeatureFlag"]
   |

Validation Error Count: 1
```

## Related pages

- [`db`](https://www.prisma.io/docs/cli/v7/db): Manage your database schema and lifecycle during development
- [`debug`](https://www.prisma.io/docs/cli/v7/debug): Display Prisma debug information including schema paths, engine binaries, environment variables, and cache directories for troubleshooting
- [`dev`](https://www.prisma.io/docs/cli/v7/dev): Start a local Prisma Postgres server for development
- [`generate`](https://www.prisma.io/docs/cli/v7/generate): Generate artifacts like Prisma Client based on your Prisma schema
- [`init`](https://www.prisma.io/docs/cli/v7/init): Set up a new Prisma project in the current directory