Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

feat(web): reframe migration headline around the compatibility deadline (#16776)

Max Deichmannab616dadbdb6
diff --git a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx
index 33da0dbf1d..983a039b2b 100644
--- a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx
+++ b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx
@@ -1,16 +1,21 @@
-import { render } from "@testing-library/react";
+import { render, screen } from "@testing-library/react";
import { MobileRightDrawer } from "@/src/components/layouts/app-layout/right-drawer/MobileRightDrawer";
+const mocks = vi.hoisted(() => ({
+ supportOpen: true,
+ migrationOpen: false,
+}));
+
vi.mock("@/src/features/support-chat/SupportDrawerProvider", () => ({
useSupportDrawer: () => ({
- open: true,
+ open: mocks.supportOpen,
setOpen: vi.fn(),
}),
}));
vi.mock("@/src/features/v4-migration/V4MigrationPanelProvider", () => ({
useV4MigrationPanel: () => ({
- open: false,
+ open: mocks.migrationOpen,
setOpen: vi.fn(),
}),
}));
@@ -23,6 +28,10 @@ vi.mock("@/src/features/v4-migration/V4MigrationPanel", () => ({
V4MigrationPanel: () => null,
}));
+vi.mock("@/src/features/v4-migration/V4MigrationContent", () => ({
+ useV4MigrationTitle: () => "Ensure compatibility after November 16",
+}));
+
function mountOverlayRoot() {
const overlayRoot = document.createElement("div");
overlayRoot.setAttribute("data-overlay-root", "");
@@ -43,6 +52,8 @@ function mountOverlayRoot() {
describe("MobileRightDrawer", () => {
beforeEach(() => {
+ mocks.supportOpen = true;
+ mocks.migrationOpen = false;
mountOverlayRoot();
});
@@ -61,4 +72,19 @@ describe("MobileRightDrawer", () => {
expect(drawer).not.toBeNull();
expect(drawer?.className).not.toContain("min-h-screen-with-banner");
});
+
+ it("includes the compatibility deadline in the accessible migration title", () => {
+ mocks.supportOpen = false;
+ mocks.migrationOpen = true;
+
+ render(
+ <MobileRightDrawer>
+ <div>page</div>
+ </MobileRightDrawer>,
+ );
+
+ expect(
+ screen.getByText("Ensure compatibility after November 16"),
+ ).toBeInTheDocument();
+ });
});
diff --git a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx
index 3e9147252a..190d9e485b 100644
--- a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx
+++ b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx
@@ -10,11 +10,13 @@ import { useSupportDrawer } from "@/src/features/support-chat/SupportDrawerProvi
import { SupportDrawer } from "@/src/features/support-chat/SupportDrawer";
import { useV4MigrationPanel } from "@/src/features/v4-migration/V4MigrationPanelProvider";
import { V4MigrationPanel } from "@/src/features/v4-migration/V4MigrationPanel";
+import { useV4MigrationTitle } from "@/src/features/v4-migration/V4MigrationContent";
export function MobileRightDrawer({ children }: PropsWithChildren) {
const { open: supportOpen, setOpen: setSupportOpen } = useSupportDrawer();
const { open: migrationOpen, setOpen: setMigrationOpen } =
useV4MigrationPanel();
+ const migrationTitle = useV4MigrationTitle();
return (
<>
@@ -64,10 +66,10 @@ export function MobileRightDrawer({ children }: PropsWithChildren) {
<div className="bg-muted h-2 w-20 rounded-full" />
</div>
{/* sr-only for screen readers and accessibility */}
- <DrawerTitle className="sr-only">Upgrade to v4</DrawerTitle>
+ <DrawerTitle className="sr-only">{migrationTitle}</DrawerTitle>
<DrawerDescription className="sr-only">
- Information about migrating to Langfuse v4 and upcoming
- deprecations.
+ Action items to keep your integrations compatible with Langfuse v4
+ and upcoming deprecations.
</DrawerDescription>
</DrawerHeader>
<V4MigrationPanel
diff --git a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
index fcbf339e63..2d3d6ead94 100644
--- a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
@@ -1264,6 +1264,7 @@ describe("V4MigrationDetailsContent", () => {
describe("V4MigrationHeaderContent", () => {
beforeEach(() => {
+ mocks.env.NEXT_PUBLIC_LANGFUSE_CLOUD_REGION = "US";
mocks.migrationData.evals = { status: "loaded", count: 0 };
mocks.migrationData.experiments = {
status: "loaded",
@@ -1283,13 +1284,18 @@ describe("V4MigrationHeaderContent", () => {
);
});
- it("uses the project-independent upgrade title and requested description", () => {
+ it("uses the project-independent compatibility title and requested description", () => {
render(<V4MigrationHeaderContent readiness="action-needed" />);
- expect(screen.getByText("Upgrade to v4")).toBeInTheDocument();
+ // The title stays off the version number: the app shell already shows a v4
+ // build, so a "upgrade to v4" headline read as a contradiction.
+ expect(
+ screen.getByText("Ensure compatibility after November 16"),
+ ).toBeInTheDocument();
+ expect(screen.queryByText("Upgrade to v4")).not.toBeInTheDocument();
expect(screen.queryByText(/Project 1/)).not.toBeInTheDocument();
expect(screen.getByText(/Langfuse v4 is live/)).toHaveTextContent(
- "Langfuse v4 is live: a re-architecture of our data model and database tables. It is up to 165× more performant in UI and on APIs. It also enables new features such as full-text search, a new filter search bar, alerts, code evaluators, and the Langfuse Assistant. Complete the action items below to switch this project over. See docs.",
+ "Langfuse v4 is live: a re-architecture of our data model and database tables. It is up to 165× more performant in UI and on APIs. It also enables new features such as full-text search, a new filter search bar, alerts, code evaluators, and the Langfuse Assistant. Complete the action items below to avoid disruption. See docs.",
);
expect(
screen.getByRole("link", { name: "full-text search" }),
@@ -1323,7 +1329,7 @@ describe("V4MigrationHeaderContent", () => {
expect(
screen.getByText(/some features may stop working/),
).toHaveTextContent(
- "After November 16, 2026 some features may stop working without a v4 upgrade.",
+ "After November 16, 2026 some features may stop working if you don't update integrations.",
);
expect(
screen.getByRole("link", { name: "November 16, 2026" }),
@@ -1337,10 +1343,11 @@ describe("V4MigrationHeaderContent", () => {
render(<V4MigrationHeaderContent readiness="action-needed" />);
+ expect(screen.getByText("Ensure compatibility")).toBeInTheDocument();
expect(screen.getByText(/features may stop working/)).toHaveTextContent(
- "Some features may stop working without an upgrade once your administrator disables the legacy mode.",
+ "Some features may stop working if you don't update integrations before your administrator disables the legacy mode.",
);
- expect(screen.queryByText(/November 16, 2026/)).not.toBeInTheDocument();
+ expect(screen.queryByText(/November 16/)).not.toBeInTheDocument();
expect(
screen.queryByRole("link", { name: "November 16, 2026" }),
).not.toBeInTheDocument();
@@ -1350,7 +1357,9 @@ describe("V4MigrationHeaderContent", () => {
// The modal host floats the dialog's fallback close button over the
// body's top-right corner; without the gutter it overlaps the title.
render(<V4MigrationHeaderContent titleRowClassName="pr-6" />);
- expect(screen.getByText("Upgrade to v4").parentElement).toHaveClass("pr-6");
+ expect(
+ screen.getByText("Ensure compatibility after November 16").parentElement,
+ ).toHaveClass("pr-6");
});
it("keeps the pitch but drops the action ask for ready or unresolved projects", () => {
diff --git a/web/src/features/v4-migration/V4MigrationContent.tsx b/web/src/features/v4-migration/V4MigrationContent.tsx
index 1201e51756..91045d0f86 100644
--- a/web/src/features/v4-migration/V4MigrationContent.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.tsx
@@ -79,6 +79,8 @@ const V4_DOCS_URL = "https://langfuse.com/docs/v4";
const V4_TIMELINE_URL = `${V4_DOCS_URL}#timeline`;
// Consumed by the status page deadline copy.
export const V4_MIGRATION_DEADLINE = "November 16, 2026";
+// Headline form of the deadline; the year is noise in a title.
+const V4_MIGRATION_DEADLINE_SHORT = "November 16";
const SDK_UPGRADE_URL =
"https://langfuse.com/docs/observability/sdk/upgrade-path";
const OTEL_V4_MIGRATION_URL =
@@ -1207,14 +1209,26 @@ export function V4MigrationDocsLink() {
);
}
+/**
+ * Headline for the migration surfaces. It names the compatibility deadline
+ * rather than a version: the app shell already shows a v4 build number, so a
+ * "upgrade to v4" title reads as a contradiction to users whose integrations,
+ * not their deployment, are the thing left to update.
+ */
+export function useV4MigrationTitle(): string {
+ return useHasV4MigrationDeadline()
+ ? `Ensure compatibility after ${V4_MIGRATION_DEADLINE_SHORT}`
+ : "Ensure compatibility";
+}
+
export function V4MigrationDeadlineNote() {
const hasDeadline = useHasV4MigrationDeadline();
if (!hasDeadline) {
return (
<p>
- Some features may stop working without an upgrade once your
- administrator disables the legacy mode.
+ Some features may stop working if you don&apos;t update integrations
+ before your administrator disables the legacy mode.
</p>
);
}
@@ -1228,7 +1242,7 @@ export function V4MigrationDeadlineNote() {
>
{V4_MIGRATION_DEADLINE}
</ExternalLink>{" "}
- some features may stop working without a v4 upgrade.
+ some features may stop working if you don&apos;t update integrations.
</p>
);
}
@@ -1248,6 +1262,7 @@ export function V4MigrationHeaderContent({
readiness?: ProjectMigrationReadiness;
}) {
const actionNeeded = readiness === "action-needed";
+ const title = useV4MigrationTitle();
return (
<>
@@ -1257,7 +1272,7 @@ export function V4MigrationHeaderContent({
titleRowClassName,
)}
>
- <p className="min-w-0 text-lg font-bold">Upgrade to v4</p>
+ <p className="min-w-0 text-lg font-bold">{title}</p>
</div>
<div className="text-muted-foreground flex flex-col gap-2 text-sm leading-relaxed">
<p>
@@ -1300,7 +1315,7 @@ export function V4MigrationHeaderContent({
</ExternalLink>
.
{actionNeeded
- ? " Complete the action items below to switch this project over."
+ ? " Complete the action items below to avoid disruption."
: ""}{" "}
<V4MigrationDocsLink />
</p>
diff --git a/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx b/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx
index f0fc01e4c8..953438e1f9 100644
--- a/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx
+++ b/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx
@@ -86,10 +86,14 @@ vi.mock("@/src/features/v4-migration/V4MigrationContent", () => ({
),
V4MigrationDeadlineNote: () => (
<p>
- After November 16, 2026 some features may stop working without a v4
- upgrade.
+ After November 16, 2026 some features may stop working if you don&apos;t
+ update integrations.
</p>
),
+ useV4MigrationTitle: () =>
+ mocks.hasDeadline
+ ? "Ensure compatibility after November 16"
+ : "Ensure compatibility",
}));
vi.mock("@/src/features/posthog-analytics/usePostHogClientCapture", () => ({
@@ -232,7 +236,9 @@ describe("V4MigrationStatusPage", () => {
it("opens the summary card with a link to the v4 docs", () => {
render(<V4MigrationStatusPage />);
- expect(screen.getByText("Upgrade to v4")).toBeInTheDocument();
+ expect(
+ screen.getByText("Ensure compatibility after November 16"),
+ ).toBeInTheDocument();
expect(screen.getByRole("link", { name: "See docs." })).toHaveAttribute(
"href",
"https://langfuse.com/docs/v4",
diff --git a/web/src/features/v4-migration/V4MigrationStatusPage.tsx b/web/src/features/v4-migration/V4MigrationStatusPage.tsx
index 259440d935..cbf45fc152 100644
--- a/web/src/features/v4-migration/V4MigrationStatusPage.tsx
+++ b/web/src/features/v4-migration/V4MigrationStatusPage.tsx
@@ -16,6 +16,7 @@ import {
import {
useCopyMigrationPrompt,
useHasV4MigrationDeadline,
+ useV4MigrationTitle,
V4MigrationDeadlineNote,
V4MigrationDocsLink,
V4_MIGRATION_DEADLINE,
@@ -476,6 +477,7 @@ function V4MigrationStatusPageContent() {
const session = useSession();
const handleCopyPrompt = useCopyMigrationPrompt();
const hasDeadline = useHasV4MigrationDeadline();
+ const title = useV4MigrationTitle();
const orgs: V4MigrationOrganization[] =
session.data?.user?.organizations?.map((org) => ({
@@ -627,11 +629,11 @@ function V4MigrationStatusPageContent() {
>
<div className="flex flex-col gap-6 pt-2 pb-24">
<Card className="flex min-w-0 flex-col gap-2.5 p-6">
- <p className="text-base font-bold">Upgrade to v4</p>
+ <p className="text-base font-bold">{title}</p>
<div className="text-muted-foreground flex flex-col gap-2 text-sm leading-relaxed">
<p>
{actionNeededProjects > 0
- ? "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items on each project below to switch over. "
+ ? "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items on each project below to avoid disruption. "
: "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. "}
<V4MigrationDocsLink />
</p>