Make your project ready for the upgrade to Langfuse v4
Langfuse v4 uses an observations-first data model. The v4 overview explains what changed. New managed projects already use v4 and need no migration.
For existing projects, complete the applicable steps below.
1. Upgrade trace ingestion
Move off legacy ingestion before the v4 cutover. Deprecated SDKs can delay data by up to 10 minutes.
| Your setup | Do this |
|---|---|
| Python SDK below 4.7.0 | Upgrade the Python SDK to 4.7.0 or later. |
| JS/TS SDK below 5.4.0 | Upgrade the JS/TS SDK to 5.4.0 or later. |
| Custom REST or OpenTelemetry ingestion | Migrate custom ingestion to the v4 OTLP/HTTP path. |
2. Migrate the v3 features you use
Only follow the rows that apply to your project.
| Check | Do this |
|---|---|
| APIs | Migrate deprecated API calls to the supported Observations, Metrics, Scores, and Experiments APIs. |
| Evaluators | Move trace-level evaluators to observation targets and legacy-dataset evaluators to experiment targets. |
| Exports | Switch blob storage exports to enriched observations. |
| Integrations | Switch PostHog and Mixpanel to enriched observations. |
3. Complete the rollout
Langfuse Cloud projects
Langfuse Cloud deprecates v3 endpoints and features on November 15, 2026. Please complete any migration requirements for your projects before this date.
Organization owners can open the Migration sidebar and the Migration status page to see if any actions are required:
We will email project owners and admins a summary of the actions required for their projects. Complete those actions by November 15, 2026.
Follow the upgrade guide for more details.
Self-hosted deployments
Self-hosted v4 is generally available. Follow the v3 to v4 upgrade guide to migrate your deployment; the legacy and dual write modes let you schedule each migration step independently.
There is no forced cutover date. Langfuse v3 receives security patches through January 2027. The self-hosted compatibility matrix lists supported SDKs and APIs.
Questions
Ask rollout and migration questions via the in-app support form or on the v4 GitHub Discussion post.
Last edited
