From e79c55549a0266dcbbc69ec5b17504b51a86086d Mon Sep 17 00:00:00 2001
From: webiny-bot <webiny-bot@webiny.com>
Date: Tue, 21 Apr 2026 14:55:07 +0000
Subject: [PATCH] chore: generate changelog for 6.3.0

---
 docs/release-notes/6.3.0/changelog.mdx     | 82 ++++++++++++++++++++++
 docs/release-notes/6.3.0/upgrade-guide.mdx | 43 ++++++++++++
 2 files changed, 125 insertions(+)
 create mode 100644 docs/release-notes/6.3.0/changelog.mdx
 create mode 100644 docs/release-notes/6.3.0/upgrade-guide.mdx

diff --git a/docs/release-notes/6.3.0/changelog.mdx b/docs/release-notes/6.3.0/changelog.mdx
new file mode 100644
index 000000000..e6669ed74
--- /dev/null
+++ b/docs/release-notes/6.3.0/changelog.mdx
@@ -0,0 +1,82 @@
+---
+id: x0qe720i
+title: Webiny 6.3.0 Changelog
+description: See what's new in Webiny version 6.3.0
+---
+
+import { GithubRelease } from "@/components/GithubRelease";
+import { Alert } from "@/components/Alert";
+
+<GithubRelease version={"6.3.0"} />
+
+## Development
+
+### TypeScript 6.0.2 with Bundler Module Resolution ([#5043](https://github.com/webiny/webiny-js/pull/5043))
+
+Webiny now uses TypeScript 6.0.2 with module resolution set to `bundler`. This aligns with modern tooling expectations and improves compatibility with bundlers like esbuild and Vite.
+
+### Install Version Flag for Upgrade Command ([#5115](https://github.com/webiny/webiny-js/pull/5115))
+
+You can now specify a custom package version when running the upgrade command:
+
+```typescript
+// Example CLI usage
+webiny upgrade --install-version=6.3.0-unstable.abc
+```
+
+This is primarily useful for testing unstable releases. If you're on version `6.2.0` and want to test `6.3.0-unstable.abc` before the stable release, you can run the upgrade process with this flag to install the unstable version while still executing the `6.3.0` upgrade steps.
+
+### Made Encryption Passphrase Optional ([#5112](https://github.com/webiny/webiny-js/pull/5112))
+
+The encryption service now works without a passphrase configured — `encrypt` and `decrypt` simply pass values through unchanged. Previously, omitting the `<Infra.Encryption passphrase="..." />` configuration would throw an error at runtime.
+
+This allows teams to adopt encryption gradually without requiring every environment to have a passphrase configured upfront.
+
+## Webiny SDK
+
+### Introducing the `Ai` Service ([#5096](https://github.com/webiny/webiny-js/pull/5096))
+
+A first-class `Ai` service is now available in the Webiny API framework, providing a single abstraction for working with language models across multiple providers. The service wraps the [Vercel AI SDK](https://sdk.vercel.ai/) and supports both Anthropic and OpenAI out of the box.
+
+```typescript
+import { Ai, Logger, Route } from "webiny/api";
+
+class MyApiRouteImpl implements Route.Interface {
+    constructor(
+        private logger: Logger.Interface,
+        private aiService: Ai.Interface
+    ) {}
+
+    async execute(request: Route.Request, reply: Route.Reply) {
+        const { text } = await this.aiService.generateText({
+            model: "anthropic/claude-sonnet-4-5",
+            prompt: "Is this working?!"
+        });
+
+        return reply.send({ message: text });
+    }
+}
+
+export default Route.createImplementation({
+    implementation: MyApiRouteImpl,
+    dependencies: [Logger, Ai]
+});
+```
+
+Configure providers via environment variables:
+- `WEBINY_API_ANTHROPIC_API_KEY` for Anthropic models
+- `WEBINY_API_OPENAI_API_KEY` for OpenAI models
+
+Switching providers is a one-line change to the model string — no other code changes needed.
+
+## Admin
+
+### Renamed "API Playground" to "GraphQL Playground" ([#5103](https://github.com/webiny/webiny-js/pull/5103))
+
+The navigation label for the API playground has been renamed from "API Playground" to "GraphQL Playground" for clarity.
+
+## Infrastructure
+
+### Automatic Cleanup of Old Pulumi Plugin Versions ([#5101](https://github.com/webiny/webiny-js/pull/5101))
+
+Previously, when new Pulumi plugin versions were downloaded, old versions were left in place. Over time, this could result in several gigabytes of unused files in the `.webiny/pulumi-cli` folder. Old plugin versions are now automatically cleaned up when new ones are installed.
diff --git a/docs/release-notes/6.3.0/upgrade-guide.mdx b/docs/release-notes/6.3.0/upgrade-guide.mdx
new file mode 100644
index 000000000..68464a657
--- /dev/null
+++ b/docs/release-notes/6.3.0/upgrade-guide.mdx
@@ -0,0 +1,43 @@
+---
+id: zq6tf829
+title: Upgrade from 6.2.x to 6.3.0
+description: Learn how to upgrade Webiny from 6.2.x to 6.3.0.
+---
+
+import { Alert } from "@/components/Alert";
+import { AdditionalNotes } from "@/components/upgrade/AdditionalNotes";
+
+<Alert type="success" title="What you'll learn">
+
+- how to upgrade Webiny from 6.2.x to 6.3.0
+
+</Alert>
+
+<Alert type="info">
+
+Make sure to check out the [6.3.0 changelog](./changelog) to get familiar with the changes introduced in this release.
+
+</Alert>
+
+## Step-by-Step Guide
+
+### 1. Upgrade Webiny Packages
+
+Upgrade all Webiny NPM packages by running the following command:
+
+```bash
+yarn up "@webiny/*@6.3.0"
+```
+
+Once the upgrade has finished, running the `yarn webiny --version` command in your terminal should return **6.3.0**.
+
+### 2. Deploy Your Project
+
+Proceed by redeploying your Webiny project:
+
+```bash
+# Execute in your project root.
+yarn webiny deploy --env {environment}
+```
+
+<AdditionalNotes />