(fix) Remove Direct URL from Prisma 7 Migration guide

[nurul3101]

Summary by CodeRabbit

• Documentation
  • Updated upgrade guide for Prisma 7 with clarified instructions on configuring datasource fields through Prisma Config.
  • Added migration guidance explaining how to properly handle directUrl configuration during the upgrade process.
  • Updated configuration examples reflecting the new setup approach.

[github-actions]

Dangerous URL check

No absolute URLs to prisma.io/docs found.
No local URLs found.

[coderabbitai]

Walkthrough

This PR updates the Prisma 7 upgrade guide documentation to clarify that deprecated datasource fields (url, directUrl, shadowDatabaseUrl) should now be configured in Prisma Config. Migration guidance is added explaining how to handle directUrl by placing its value into the url field in prisma.config.ts, with a corresponding code example correction.

Changes

Cohort / File(s)	Summary
Prisma 7 Upgrade Guide Documentation content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx	Rewrote deprecated notice for datasource fields to direct users to Prisma Config; added migration guidance for directUrl handling; removed directUrl line from prisma.config.ts code example

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

• Single documentation file with textual updates and a straightforward code example modification
• No logic changes, API modifications, or exported entity declarations affected
• Minimal scope—primarily clarifying existing deprecation messaging and providing configuration guidance

Possibly related PRs

• docs(): add v7 migration guide #7249 — Modifies the same upgrade guide file and addresses the same datasource fields deprecation and Prisma Config migration messaging
• Update docs to perform migrations with connection pooling and Prisma config #7266 — Provides related guidance on removing datasource.directUrl and directing users to configure URLs in prisma.config.ts
• DC-6174: Remove adapter, engine, directUrl, studio from config #7256 — Directly addresses the same deprecation pattern—removal of datasource.directUrl and migration of URL configuration to prisma.config.ts

Pre-merge checks

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main change: updating the Prisma 7 migration guide by removing directUrl from configuration examples and clarifying how to handle it.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a4b3e68 and 0156ac3.

📒 Files selected for processing (1)

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx (1 hunks)

🧰 Additional context used

🧠 Learnings (4)

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-08-11T09:40:55.237Z

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

📚 Learning: 2025-10-09T21:32:50.340Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-84
Timestamp: 2025-10-09T21:32:50.340Z
Learning: The `npx prisma init` command supports the following flags: `--db` (shorthand for `--datasource-provider prisma+postgres`), `--output` (specifies output location for generated client), `--generator-provider` (defines the generator provider), `--datasource-provider`, `--url`, `--preview-feature`, and `--with-model`. These are documented valid CLI options for Prisma init command.

Applied to files:

• content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

• GitHub Check: Check internal links
• GitHub Check: Cloudflare Pages

🔇 Additional comments (1)

content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx (1)

130-143: Solid migration guidance and example for datasource configuration.

The deprecation notice at line 130 clearly states that these fields now belong in Prisma Config, and the specific guidance at line 132 provides an actionable path for users migrating from directUrl. The code example correctly demonstrates the target configuration state—showing url and shadowDatabaseUrl without directUrl, which reinforces that the directUrl value should be relocated into the url field as instructed.

Tip

📝 Customizable high-level summaries are now available in beta!

You can now customize how CodeRabbit generates the high-level summary in your pull requests — including its content, structure, tone, and formatting.

• Provide your own instructions using the high_level_summary_instructions setting.
• Format the summary however you like (bullet lists, tables, multi-section layouts, contributor stats, etc.).
• Use high_level_summary_in_walkthrough to move the summary from the description to the walkthrough section.

Example instruction:

"Divide the high-level summary into five sections:

1. 📝 Description — Summarize the main change in 50–60 words, explaining what was done.
2. 📓 References — List relevant issues, discussions, documentation, or related PRs.
3. 📦 Dependencies & Requirements — Mention any new/updated dependencies, environment variable changes, or configuration updates.
4. 📊 Contributor Summary — Include a Markdown table showing contributions:
   | Contributor | Lines Added | Lines Removed | Files Changed |
5. ✔️ Additional Notes — Add any extra reviewer context.
   Keep each section concise (under 200 words) and use bullet or numbered lists for clarity."

Note: This feature is currently in beta for Pro-tier users, and pricing will be announced later.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

original	preview
content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx	content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/400-upgrading-to-prisma-7.mdx

[github-actions]

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

• This PR does not change any pages in a way that would require a redirect.

[github-actions]

🍈 Lychee Link Check Report

Note: Links are cached for 5 minutes. Failed links (timeouts, rate limits) are retried in a second run with longer timeout.

📊 Results Overview

Status	Count
🔍 Total	2235
✅ Successful	2197
⏳ Timeouts	0
🔀 Redirected	4
👻 Excluded	23
❓ Unknown	0
🚫 Errors	10
⛔ Unsupported	1

Errors per input

Errors in 200-orm/500-reference/250-error-reference.mdx

• [404] http://pris.ly/d/connection-pool | Error (cached)
• [404] https://pris.ly/d/migrate | Error (cached)
• [404] https://pris.ly/d/migrate-no-direct-ddl | Error (cached)
• [404] https://pris.ly/d/migrate-no-foreign-keys | Error (cached)
• [404] https://pris.ly/d/migrate-provider-switch | Error (cached)
• [404] https://pris.ly/d/migrate-resolve | Error (cached)
• [404] https://pris.ly/d/migrate-shadow | Error (cached)

Errors in 800-guides/050-migrate-from-mongoose.mdx

• [404] https://github.com/Automattic/mongoose/tree/master/examples/express | Error (cached)

Errors in 800-guides/370-bun.mdx

• [404] https://pris.ly/bun-guide-example | Rejected status code (this depends on your "accept" configuration): Not Found