●Change8

Migrating to Prisma 7.0.0

Version 7.0.0 introduces 9 breaking changes. This guide details how to update your code.

Released: 11/19/2025

9
Breaking Changes
7
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

PrismaClientprisma-clientprisma-client-jsPrismaBetterSQLite3PrismaBetterSqlite3PrismaD1HTTPPrismaD1HttpPrismaLibSQLPrismaLibSqlPrismaNeonHTTPPrismaNeonHttpdefineConfiglistLocalDatabases@prisma/client-runtime-utils

Breaking Changes

●Issue #1

The ESM Prisma Client is now the default; 'prisma-client-js' provider is replaced by 'prisma-client'.

●Issue #2

PrismaClient constructor now requires an 'adapter' or 'accelerateUrl'. Default empty constructors are no longer supported.

●Issue #3

The 'output' path in schema.prisma is now mandatory; generated files no longer reside in node_modules by default.

●Issue #4

Implicit commands (post-install generate, migrate-triggered generate/seed) have been removed.

●Issue #5

MongoDB is currently unsupported in version 7.0.0.

●Issue #6

Automatic loading of environment variables by the Prisma CLI has been removed.

●Issue #7

The 'prisma.config.ts' file is now required for introspection and migration tasks.

●Issue #8

Removed support for 'datasources', 'datasourceUrl', and 'directUrl' in the PrismaClient constructor and schema.

●Issue #9

Renamed several Driver Adapter classes for naming standardization.

Migration Steps

  1. 1
    Update 'provider' in schema.prisma from 'prisma-client-js' to 'prisma-client'.
  2. 2
    Add an 'output' path to the generator block in schema.prisma (e.g., output = '../src/generated/prisma').
  3. 3
    Create a 'prisma.config.ts' file and move 'url' and 'shadowDatabaseUrl' from the schema to this config.
  4. 4
    Update PrismaClient instantiation to pass a driver adapter (e.g., new PrismaClient({ adapter })).
  5. 5
    Update import statements to point to the new custom 'output' directory.
  6. 6
    Manually run 'prisma generate' and 'prisma seed' as they are no longer triggered implicitly.
  7. 7
    Install 'dotenv' or similar to manually load environment variables before running Prisma CLI commands.

Release Summary

Prisma 7.0.0 makes the ESM-based Prisma Client the default, significantly reducing bundle sizes and improving performance. It introduces a mandatory configuration file (prisma.config.ts) and requires explicit driver adapter injection and output paths.

Need More Details?

View the full release notes and all changes for Prisma 7.0.0.

View Full Changelog