# migration show (/docs/cli/migration-show)

Inspect a Prisma ORM migration package.

Location: CLI > migration show

`migration show` displays the operations, statement preview, and metadata for one migration package.

Use this command during review before applying a migration package. The command is offline. It does not consult the database.

## Usage

#### bun

```bash
bunx prisma migration show <target>
```

#### pnpm

```bash
pnpm prisma migration show <target>
```

#### yarn

```bash
yarn prisma migration show <target>
```

#### npm

```bash
npx prisma migration show <target>
```

## Options

| Argument or option | What it does                                                                         |
| ------------------ | ------------------------------------------------------------------------------------ |
| `<target>`         | The migration to inspect: a directory name, a hash or hash prefix, a ref, or a path. |
| `--config <path>`  | Read this config file instead of `./prisma.config.ts`.                               |
| `--json`           | Prints a machine-readable result.                                                    |

## Examples

#### bun

```bash
bunx prisma migration show 20260101_100000_add_user
bunx prisma migration show a1b2c3
bunx prisma migration show migrations/app/20260101_100000_add_user
bunx prisma migration show 20260101_100000_add_user --json
```

#### pnpm

```bash
pnpm prisma migration show 20260101_100000_add_user
pnpm prisma migration show a1b2c3
pnpm prisma migration show migrations/app/20260101_100000_add_user
pnpm prisma migration show 20260101_100000_add_user --json
```

#### yarn

```bash
yarn prisma migration show 20260101_100000_add_user
yarn prisma migration show a1b2c3
yarn prisma migration show migrations/app/20260101_100000_add_user
yarn prisma migration show 20260101_100000_add_user --json
```

#### npm

```bash
npx prisma migration show 20260101_100000_add_user
npx prisma migration show a1b2c3
npx prisma migration show migrations/app/20260101_100000_add_user
npx prisma migration show 20260101_100000_add_user --json
```

## What to check

Before applying, review:

- the source and destination contract hashes
- the planned operations
- generated SQL statements or operation payloads
- the migration's metadata

## Related pages

- [`auth`](/guides/platform-auth): Sign in to your Prisma account from the CLI, sign out, and manage workspace sessions.
- [`branch`](/guides/platform-branch): List platform branches for a project.
- [`bucket`](/guides/platform-bucket): Create and manage object-store buckets.
- [`Configuration`](/guides/introduction-6-configuration): Configure Prisma ORM CLI commands with prisma.config.ts and global flags.
- [`contract emit`](/guides/orm-contract-emit): Emit Prisma ORM contract artifacts.

## Related pages

- [Authentication & Tools](./authentication-tools-index.md)
- [Build](./build-index.md)
- [Changelog](../changelog.md)
- [Concepts](./concepts-index.md)
- [Console commands](./console-commands-index.md)
- [Contract Authoring](./contract-authoring-index.md)
- [Core Concepts](./core-concepts-index.md)
- [Data Modeling](./data-modeling-index.md)
- [Database](./database-index.md)
- [DB commands](./db-commands-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.
