How to export your data from LangSmith before a plan change or exit
If you are facing a renewal, a plan change or a move off LangSmith, the documented path for keeping your traces is scheduled bulk export of trace data to an S3-compatible bucket in Parquet format. Whether you can use it depends on your sign-up date: customers who signed up after August 3, 2026 get bulk export only on the Enterprise plan, while earlier Plus customers keep access until February 1, 2027. Confirm your account's sign-up date and current plan with LangChain before you plan the export window, because that date decides how much time you have.
The bulk export covers trace data. It does not give you a complete copy of everything you have in LangSmith, so inventory the rest before you rely on it. Check your prompt versions in the prompt hub, your datasets and examples, your annotation queues, your online evaluator rules and any feedback scores you rely on, and export or record each one separately. Ask LangChain whether the export includes run-level evaluation results and feedback, and confirm the exact Parquet schema in the export documentation, since you will need that schema to map fields onto a new project.
Plan for run time and storage on your side. Bulk export is a scheduled job, so test it on a narrow date range first, note how long it takes and confirm that the bucket receives complete files, including the final partial day. Confirm the bucket's access policy, encryption and retention settings before writing production data to it, and keep a checksum or record count so you can prove later that the export is complete. Once the files are in your bucket, the mapping to a self-hosted Langfuse or Opik project is a separate engineering task that needs its own test import.
What LangSmith exports and in which format
This table maps each LangSmith data type to its documented export path, format, destination and plan rules. Read it before planning a migration, because the documented bulk export covers trace data, and the facts supplied do not confirm how datasets, experiments or prompts leave the platform. Check any row marked as unconfirmed with LangChain before you write it into a project plan.
| Data type | Documented export method | Format, destination and plan rule |
|---|---|---|
| Trace data | Scheduled bulk export to an S3-compatible bucket | Parquet files in your bucket. Customers who signed up after August 3, 2026 need the Enterprise plan. Earlier Plus customers keep access until February 1, 2027. |
| Trace data, Plus plan after February 1, 2027 | Not confirmed as available | Confirm with LangChain whether Plus accounts keep bulk export access after February 1, 2027 and whether any replacement path exists. |
| Evaluation results and online evaluator output | Not confirmed in the bulk export documentation | Confirm with LangChain whether evaluator scores and feedback are included in the Parquet trace export or need a separate API call. |
| Datasets and examples | Not confirmed in the bulk export documentation | Confirm whether dataset examples are exported in bulk, or whether you must pull them through the API or SDK before the move. |
| Experiments | Not confirmed in the bulk export documentation | Confirm whether experiment results and their linked runs are covered, and in what format. |
| Prompts (prompt hub) | Not confirmed in the bulk export documentation | Confirm whether prompt versions are exported. Plan to copy prompt text manually if LangChain does not confirm a method. |
| Destination bucket | S3-compatible storage that you configure | Confirm bucket permissions, region and any cross-region transfer rules for your data residency requirements. |
What does not come out through bulk export and how to handle it
The bulk export path covers trace data in Parquet, but several LangSmith artifacts sit outside it. The cards below cover the items most teams discover late, with a workaround for each and a check to run against current vendor documentation before you start the migration.
Prompt hub contents
Prompts saved in the LangSmith prompt hub, along with their version history and tags, are a separate object from the traces in a bulk export. Teams that rely on named prompt versions should copy each prompt manually through the UI or the LangSmith API, recording the version and label used by each production application. In the target tool, recreate the prompts as versioned prompts with labels, such as Langfuse prompt management or Opik's prompt library. Confirm with LangChain whether the export now includes any prompt content, since coverage can change.
Annotation queue state
Annotation queues hold reviewer assignments, pending items and human labels that were applied to runs. Traces may come out in the bulk export, but the queue definitions, who was assigned what, and which items were still open are not clearly part of that file. Before cutover, decide whether open queues need to be drained, then export the labeled feedback attached to runs and map it to the scores or annotations in the target project. Check the export schema for feedback fields.
Online evaluator configuration
Online evaluators are rules that score production runs automatically, with their judge prompts, sampling rates and filters. These settings live in the LangSmith project configuration rather than in trace data, so a bulk export will not reproduce them. Copy each evaluator's prompt, model, sampling rate and filter into a document, then rebuild them as online evaluation rules in the target tool. Run both in parallel for a short period to confirm the scores match in direction and rough range.
Datasets and experiment links
Datasets and the experiments that ran against them are central to regression testing, yet the bulk export of traces does not guarantee that example inputs, expected outputs and experiment comparisons are carried over. Export each dataset through the API or SDK as JSON, then re-upload it to the target project. Experiment history usually cannot be recreated, so record baseline scores in your own system before the move.
Users, roles and workspace settings
Workspace members, roles, API keys, service accounts and project-level access rules are administrative data rather than trace data. None of them are carried into a Langfuse or Opik project by an export. Build an inventory from the LangSmith settings pages, then recreate roles in the target tool. Rotate or reissue API keys in the application configuration, since keys do not transfer, and confirm SSO and RBAC availability for your plan in the target.
Retention and tracing configuration
Project-level settings such as the retention period, sampling, tags, metadata conventions and the tracing environment variables used by each service define how data is captured and kept. Export the current values for every project, since the bulk export reflects what was stored, not the rules that produced it. Reproduce the retention policy in the target deployment, and document it, because the window in the new system is controlled by your own storage rather than the vendor's plan.
Which LangSmith plans still include Parquet bulk export after August 2026
The cutoff is August 3, 2026, and it depends on when your organization signed up, not only on the plan name you see today. Customers who signed up after that date get LangSmith bulk export, which writes trace data to an S3-compatible bucket in Parquet format, only on the Enterprise plan. Customers who signed up earlier on the Plus plan keep access until February 1, 2027. Confirm this against the current LangSmith bulk export documentation before you plan, because the terms are the vendor's to state and may be updated.
To check where you stand, ask the account owner for the sign-up date recorded on the LangChain account and the plan shown in workspace billing settings, then record both in your migration ticket. If the sign-up date is after August 3, 2026, and you are not on Enterprise, the export path is closed to you unless you change plans or find another route, so a Parquet export is not a safe assumption for your timeline. If you signed up earlier and are on Plus, you have a fixed window that ends February 1, 2027, and that window should set your schedule. Ask the vendor in writing whether any grace period or exception applies to your account.
The timing changes the order of work. Start the bulk export and a test restore into a self-hosted Langfuse or Opik project before the access date, not after the migration design is finished, because a large trace history can take time to export and load. Keep the export files, the schema notes and a checksum record in storage you control, so the data stays available if access changes again. Plan the rebuild of prompts, datasets and evaluators as a separate track, since bulk export covers trace data and does not replace those objects.
Sequence for a complete LangSmith export with verification
This sequence moves LangSmith trace data into a bucket you control, proves the copy is complete and readable, and keeps the evidence needed before the source data is touched again.
Confirm plan and sign-up date
Check the account owner's billing settings and the plan tier in LangSmith before anything else. Bulk export to an S3-compatible bucket in Parquet is available on the Enterprise plan for customers who signed up after August 3, 2026. Earlier Plus customers keep access until February 1, 2027. Record the plan, the sign-up date and the name of the person who confirmed both. If the account does not qualify, stop here and confirm the options with LangChain before continuing, because the rest of the sequence depends on the export feature being available to your account.
Provision the destination bucket
Your platform or cloud team creates an S3-compatible bucket in an account and region you control, with encryption at rest, access limited to named roles, and a retention or lifecycle policy you set. Keep a separate prefix for each LangSmith project so files stay traceable. Confirm the bucket's region matches your data residency requirements, since LangSmith Cloud keeps data in the region where the account signed up. The step is done when a test object can be written and read by the export role and denied to everyone else.
Configure the scheduled export
An administrator sets up the bulk export in LangSmith's data export settings, pointing it at the bucket, the access credentials and the project or projects to include. Document the schedule, the credentials' owner and the rotation date for those credentials. Run a single manual export first if the interface allows it, and confirm that files appear under the expected prefix. The step is done when the configuration is saved in your change record and the first run's files are visible in the bucket.
Backfill a bounded date range first
Start the historical backfill with a short, bounded date range rather than the full history. This surfaces permission errors, naming conventions and file layout problems on a small volume of data. Note the range, the start and end times of the job, and the number of files produced. Ask LangChain support to confirm how long a backfill can run and whether large ranges time out, because those limits are not part of the researched facts for this page. The step is done when the bounded range completes and its files pass a first look at structure.
Split ranges when exports time out
If a backfill job times out or fails partway, do not retry the full range. Split the failed period into smaller date windows and export each one separately, recording which windows completed. Keep the window boundaries non-overlapping, or deduplicate by trace ID later, so no trace is counted twice or dropped. The step is done when every window in the plan has a completed status in your log and the gaps between windows are accounted for.
Verify object counts, schema and row counts
Compare the exported files with the LangSmith project before trusting them. Check that the number of files matches each window, that the Parquet schema is the same across files, and that row counts for each window match the counts LangSmith reports for the same project and period. Where LangSmith does not show an exact count, agree on the method with your reviewer and record it. The step is done when each window has a matching count and schema record, and any difference has a written explanation.
Spot-check trace IDs against the source
Select a random sample of trace IDs from several windows, including recent and older traces, and confirm each one exists in the Parquet data with the expected inputs, outputs, timestamps and metadata. Compare the sampled records with what LangSmith shows for the same traces. The sample size and selection method should be agreed in advance and written down. The step is done when every sampled trace matches and any mismatch has a root cause and a rerun of the affected window.
Record checksums and hold the export
Compute checksums for every Parquet file, store the manifest of file names, sizes, checksums and window boundaries in a location separate from the bucket, and keep the export until the target project is confirmed. The target project may be a self-hosted Langfuse or Opik deployment, and the import is confirmed only after its trace counts and sample checks match this manifest. Do not delete the source export or let retention rules expire it before that confirmation. The step is done when the signed manifest exists and the owner has written approval to release the export.
How to handle run timeouts on large trace exports
Large LangSmith projects can time out during a single bulk export, so the practical fix is to split the export into smaller time windows and run them as separate jobs rather than one large job. Pick a window length that keeps each job's trace volume modest, export one window at a time, and record for each window its project name, start and end timestamps, the job identifier, the output path in the S3-compatible bucket, the row count if your tooling reports it, and the final status. A simple run log in a spreadsheet or a small table in your own database is enough. Re-run only the windows that failed or did not finish, and keep the original window boundaries so the retry lands in the same place.
Once the windows are done, check the seams. Adjacent windows should meet exactly at their boundary, so compare each window's end timestamp with the next window's start. A gap means traces created in that interval may be missing from your copy, and an overlap means the same runs may appear twice once you load the Parquet files into a self-hosted Langfuse or Opik project. Deduplicate on the run identifier carried in the export rather than on file names, and count rows per window against the figures in your log before you delete anything in LangSmith. Timestamps near a window edge deserve extra attention because runs that started before a boundary and finished after it can be assigned unpredictably depending on which field your filter uses.
Before you plan the window size, confirm with LangChain what limits apply to your plan, including any run time, file size or concurrency limits on bulk export, and whether those limits differ for the Plus and Enterprise plans during the transition described in the LangSmith bulk export documentation. Ask whether a failed job can be resumed or must be restarted, and how long exported files remain available in the bucket. Record the answers in your migration runbook, because they set how many windows you need and whether you can finish the copy before your access ends.
How Parquet fields map onto Langfuse or Opik
Langfuse organizes captured LLM activity into traces, which group observations such as generations and spans. Scores, datasets and prompts sit alongside them. A mapping from a LangSmith Parquet export starts by deciding how each exported run becomes an observation under a trace, and which fields become scores, dataset items or prompt versions. Most of the work is a transformation script that sends the reshaped records through Langfuse's OpenTelemetry or SDK ingestion path, so the target database stays under Langfuse's control.
- Runs to observations: Map each exported run to a generation or span and keep parent and child links, so nested chains rebuild the same tree.
- Model and usage fields: Model names, token counts and cost values need to land in the generation attributes that Langfuse reads. Confirm which usage fields the export contains before assuming totals carry over.
- Feedback to scores: LangSmith feedback records become Langfuse scores. Each metric needs one stable score name and a consistent data type.
- Datasets and prompts: Dataset examples map to dataset items. Prompt text and version labels usually need a separate import, because Langfuse keeps its own prompt versions.
- Timestamps and identifiers: Keep original start and end times and source IDs in metadata, so historical traces stay searchable and the import can be rerun safely.
Check each mapping against the column names, nested types and null patterns in your own export, since these are the fields most likely to differ from this list.
Opik stores work as traces and spans, attaches feedback scores to them, and keeps datasets and prompts in the same self-hosted platform. Because the whole platform, including evaluations and prompt management, runs without a license key, the mapping decisions focus on preserving nesting, scores and dataset structure. Opik supports OpenTelemetry and offers a @track decorator for custom code, so a transformation can either replay exported runs through its SDK or write spans through OpenTelemetry.
- Runs to traces and spans: Map top-level runs to traces and child runs to spans, preserving parent references so the hierarchy in the Opik interface matches the original.
- Inputs, outputs and metadata: Store LangSmith tags, run types and custom metadata as Opik metadata or tags, so filters you use today still work after the move.
- Feedback to feedback scores: Convert feedback records into Opik feedback scores. Agree on score names and value ranges before the import, because mixed scales are hard to compare later.
- Datasets and experiments: Rebuild dataset items from exported examples. Experiment results are usually recalculated in Opik rather than copied as-is, so plan a rerun of key evaluators.
- Historical volume: Batch imports by time range and confirm that the target ClickHouse, MySQL and Redis stack has the storage headroom for the full history.
Verify the field names, nesting and timestamp formats in your own Parquet files against this list before writing the transformation, because the export may not match these assumptions.
Neither target can be mapped reliably from a description alone. The field names, nested structures and data types in a LangSmith bulk export depend on the trace types and plan settings used for your account. Before choosing between Langfuse and Opik, open a sample of the Parquet files with a standard reader and record the actual schema. LangSmith's export documentation describes the delivery method and the Parquet format, so use it as the starting reference for what to inspect.
- Schema inventory: List every column, its type and whether nested fields are stored as structured records or as serialized JSON strings.
- Sample rows: Read a few traces with children, feedback and errors, so you see how parent references, nulls and empty arrays appear in practice.
- Time and identifier formats: Record timestamp precision, time zone handling and ID formats, since mismatches here cause the most duplicate or missing records.
- Coverage gaps: Note fields you need that are absent from the export, such as particular feedback types or prompt history, and plan how to recover them.
- Test import: Run the transformation on a small window in a non-production instance and compare counts and sample traces against LangSmith.
Run this check with the team that owns the export, and document the confirmed schema in the migration record before any production import starts.
What to plan before the LangSmith renewal or termination
The export is only useful if the decisions around it are made in the right order. Eligibility, retention, the target platform and staffing all shape how much data you move and when, so settle them before the renewal or termination date.
Confirm sign-up date and plan
Check when your organization signed up and which LangSmith plan is active. Bulk export to Parquet is only available on the Enterprise plan for customers who signed up after August 3, 2026, while earlier Plus customers keep access until February 1, 2027. Read the exact eligibility terms in your own agreement and confirm them with your LangChain account contact, since the answer decides how long you can export.
Keep export jobs running until verified
Do not switch off the bucket, export schedule or credentials when the renewal date passes. Keep them active until you have compared row counts and sample traces in the exported Parquet files against what you need to keep. Document who signs off on verification, because a missed window can leave gaps you cannot recover from LangSmith.
Set retention for exported data
Decide how long exported traces, datasets and evaluation results must stay, and who approves that period. Your retention policy for the target platform should match the policy you already apply to similar data, not the period LangSmith offered. Confirm the storage cost of that period in your own bucket, because it grows with volume and is paid by you, not by LangSmith.
Decide the target platform
Choose the destination before the export, because the Parquet files map onto a Langfuse or Opik project differently. Langfuse fits teams that want tracing, prompt versions and annotation in one self-hosted system. Opik fits teams that need the whole platform, including evaluations and prompt management, under an Apache-2.0 license without a license key. Phoenix is a third option, but check its Elastic License 2.0 terms first.
Budget for infrastructure and staff
Plan the cost of the target stack: PostgreSQL, ClickHouse, Redis or Valkey, blob storage, and the people who run upgrades and backups. Self-hosted Langfuse documents minimum resources such as 16 GiB of ClickHouse memory for larger deployments, and a major upgrade requires ClickHouse 25.12 or later. Ask providers for a written scope that names these components, and budget for the ongoing operations that recur after the migration.
Review self-hosting terms if relevant
Review LangSmith's Enterprise self-hosting terms only if they affect your decision, for example if you were considering self-hosting LangSmith instead of leaving it. Self-hosted LangSmith is an add-on to the Enterprise plan and needs a license key. Read the license and billing terms in your own agreement, and confirm with LangChain what telemetry and connectivity the license requires.
Questions teams ask before exporting LangSmith data
How much effort does exporting LangSmith data actually take?
The effort depends less on the export job itself than on what you do with the files afterward. Running the scheduled bulk export to an S3-compatible bucket in Parquet format is configuration work. The larger effort comes from four drivers: the total volume of trace data you need to keep, the retention window you want to preserve, the schema mapping from LangSmith's Parquet layout into the data model of your target platform, and the verification that proves the copy is complete. Teams with a small set of projects and a short history usually face a narrow job. Teams with years of traces, many projects and nested agent runs face a larger one, mainly because mapping and verification scale with the number of distinct structures in the data. Ask any provider to split the estimate into these four parts so you can see which one drives the cost.
Can our own engineers run the LangSmith export without outside help?
Yes, a capable platform engineer can configure the bulk export and pull the Parquet files, and many teams do this in-house. What is less obvious is the work after the files land. Someone has to decide how LangSmith run and trace fields map onto the tables of a self-hosted Langfuse or Opik project, write and test that mapping, handle edge cases such as very large inputs or runs that were still open at export time, and prove that counts and identifiers match between source and destination. If your team already owns Parquet tooling, ClickHouse or PostgreSQL administration and an S3-compatible bucket, the gap is usually the mapping and verification. If none of these skills sit in-house, outside help can cover that gap without taking over your operations.
What does the export need from our side before work starts?
Before any export runs, you need four inputs. First, an S3-compatible bucket with a defined location, access logging and a retention rule that matches your policy. Second, an IAM identity or equivalent credentials scoped to write to that bucket and nothing else, with rotation handled under your existing secrets process. Third, named engineering time from the team that owns the destination platform, because someone must confirm the schema and the target project layout. Fourth, a sign-off owner who accepts the verification results, usually a data owner or a security lead who will be asked whether the copy is complete and where it lives. Agree on these in writing, because a missing sign-off is the most common reason an export stalls after the technical work is finished.
How long does a LangSmith export take from start to finish?
No duration figure is supplied for this work, so treat any number you hear as a claim to verify. The timeline is set by volume, the number of projects and environments, how many schema variants appear in the data, and how quickly your reviewers can sign off. Run timeouts are a practical factor: large exports may need to be split by time window or project so that individual runs complete reliably, and each split adds planning and checking. A fixed-scope engagement puts the phases, dependencies and acceptance points into writing before work begins. Ask for the schedule to show which steps wait on your team, such as bucket provisioning or sign-off, since those waits often set the calendar more than the technical work does.
Does the bulk export include prompts, datasets and evaluation results?
The bulk export described in LangSmith's documentation covers trace data written to the bucket in Parquet format, and that is what the supplied facts establish. Prompts, datasets, annotation queues, evaluator configurations and experiment metadata should be treated as separate items that need their own extraction path, and you should confirm with LangSmith's current documentation and your own account exactly which of these are included in the export. Plan for them explicitly. Prompt versions usually need to be recreated in the target platform's prompt management, and datasets often need a separate export through the API. Ask a provider to inventory every object type in your workspace so nothing is assumed to be covered by the trace export.
Which plans can still use the LangSmith bulk export?
According to LangSmith's data export documentation, customers who signed up after August 3, 2026 can use bulk export only on the Enterprise plan. Earlier Plus customers keep access until February 1, 2027. If you are on Plus and signed up before that date, the export window has a fixed end, so the planning question is how quickly you can schedule the work, not whether the feature exists today. Confirm your account's plan and sign-up date in LangSmith directly, because the access rule depends on the account, and do not assume a plan change will keep the feature available.
What should we ask for in a fixed-scope quote for this export?
Ask for a written scope that names the source objects, the target platform (self-hosted Langfuse or Opik), the schema mapping you will receive, the verification method and the acceptance criteria. The quote should list deliverables, such as the export configuration, mapping documentation, a reconciliation report and a runbook, along with the dependencies on your team. Ask which items are one-time work and which recur, for example if you need ongoing exports during a parallel run. Request the assumptions about data volume and retention, a clear statement of what is excluded, and how change requests are handled if the data turns out to be larger or more varied than expected. DeployOpen works on fixed scopes agreed in writing before work starts, and does not publish a price list, so the written scope is what the quote follows from.
How do we confirm the exported data is complete and accurate?
Verification should compare the source and the copy at several levels: total record counts per project and time window, identifier matches for traces and runs, spot checks of nested agent steps, and checks that timestamps, token counts and status fields survived the mapping. Use a sample of records that engineers read by hand, because automated counts can match while fields are shifted or truncated. Document the method and the tolerance for differences, and have the sign-off owner accept the reconciliation report before the source is retired. Keep the Parquet files and the report under your retention policy so the evidence remains available if a question arises later. This work prepares evidence for your own reviews and does not replace an independent audit where one is required.
Official LangSmith documentation for the export
Before you schedule anything, treat LangSmith's own documentation as the authority on who can export and where your data lives. The bulk data export page explains how trace data is written to an S3-compatible bucket in Parquet format, and it is the page that sets the plan rule for this export: customers who signed up after August 3, 2026 can use it only on the Enterprise plan, while earlier Plus customers keep access until February 1, 2027. Check that page on the day you start, confirm which plan your account is on, and record the date and the plan name in your migration plan so the decision is traceable later.
Then read the self-hosting and cloud documentation side by side. The Cloud documentation lists the GCP US (Iowa), GCP EU (Netherlands), GCP APAC (Sydney) and AWS US (Ohio) regions, and states that data stays in the region where the account signed up while billing information stays in the US. The self-hosted documentation explains the Enterprise add-on, license key and Kubernetes deployment. Use both to confirm which region holds your exported data today, because the export inherits that residency, and to confirm whether your contract covers any self-hosted option you might compare against.
Ask your LangChain account contact to confirm three things in writing: the export format and file layout for your account, any run-time limits on large exports, and the bucket requirements for the S3-compatible destination. Documentation can change between releases, so the written answer is the one you should rely on. Keep a copy of every page you rely on, with the date you read it, so your evidence matches the rules that applied when you ran the export.
How DeployOpen scopes and delivers a LangSmith data exit
DeployOpen is a Chainscore Labs company that plans, implements, documents and supports self-hosted open-source platforms inside the client's own infrastructure. For a LangSmith data exit, we start from the traces and evaluation data you need to keep, then build and verify the export and the self-hosted target in your environment.
How we scope
- Inventory the LangSmith projects, trace volumes, datasets and evaluation runs that must leave the platform
- Confirm your LangSmith plan, export access and the bucket or storage location you control
- Agree the target platform, retention rules and cutover approach in a written, fixed-scope agreement
How we build
- Configure scheduled Parquet exports to your S3-compatible bucket and test run timeouts on realistic date ranges
- Map exported Parquet fields onto the Langfuse or Opik project structure and load a verification sample
- Deploy the self-hosted target with its database, ClickHouse and blob storage dependencies in your own cloud or data center
How we hand over
- Document the export job, field mappings, verification steps and known gaps in a handover pack
- Reconcile record counts and sampled traces between the export and the target system, and record the results
- Train your platform team on operating the target, including access controls and where exported data is stored
How we support
- Engagements are fixed-scope, and ongoing support, upgrades and continuous testing are available as a retainer
- Agree the upgrade path for the self-hosted target, including dedicated migration guides for major versions
- Confirm with your LangSmith account team and your own compliance owners which retention and residency evidence you need

