●Change8

Migrating to Unstructured 0.25.0

Version 0.25.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/31/2026

1
Breaking Changes
1
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

partition_json()partition_ndjson()partition()detect_filetype()elements_from_dicts()reconstruct_table_from_chunks()is_json_processable()is_ndjson_processable()FileType.JSON

Breaking Changes

●Issue #1

NDJSON files where the first record exceeds 1 MiB will now be classified as JSON and cause `partition()` to raise a `ValueError`. Previously, these would be correctly identified as ND To fix this, call `partition_ndjson()` directly if you encounter this specific scenario.

Migration Steps

  1. 1
    If you encounter NDJSON files where the first record exceeds 1 MiB and `partition()` raises a `ValueError`, switch to calling `partition_ndjson()` directly for those specific files.

Release Summary

Enhanced JSON and NDJSON partitioning to handle arbitrary payloads and improved table chunk rehydration. Deprecated prefix-sniffing helpers for file type detection.

Need More Details?

View the full release notes and all changes for Unstructured 0.25.0.

View Full Changelog