Source: Unstructured Docs on Partitioning, Elements and Hi-Res Models
Unstructured's open-source documentation on partition strategies (auto, fast, hi_res, ocr_only), the element types and metadata it emits, and the layout models behind hi_res.
Contents
- What: official documentation pages (partitioning strategies, document elements, hi-res model selection)
- Author/publisher: Unstructured Technologies
- Date: living documents; read 2026-11-14
- Original: Partitioning strategies, Document elements, Models, API: choose hi-res model
Summary
Unstructured’s library “partitions” a file into a flat list of typed elements with metadata. For PDFs and images the strategy parameter chooses between fast rule-based text extraction and slower model-based layout detection and OCR. Elements carry page numbers, coordinates, parent links and, for tables, an HTML rendering.
Key claims
- Strategies:
auto(default, chooses from document characteristics and arguments);fast(rule-based text extraction, roughly 100x faster than image-to-text models, not for image-based files);hi_res(model-based layout detection used to classify elements, use when classification matters);ocr_only(OCR text extraction for image-based files). PDFs support all four; images supportauto,hi_res,ocr_only. - Element types: Title, NarrativeText, ListItem, Table, Image, Header, Footer, Formula, FigureCaption, Address, EmailAddress, PageBreak, CodeSnippet, PageNumber, UncategorizedText;
CompositeElementonly appears after chunking. - Metadata:
page_number,coordinates(points, top-left origin),parent_id(hierarchy),languages,detection_class_prob(hi_res only), andtext_as_htmlon Table elements. - Table extraction is on by default unless
skip_infer_table_typesis set; the table’s plain text is intextand its structure inmetadata.text_as_html. - Hi-res models (as of 2026-11): the open-source models page lists
yoloxanddetectron2_onnx, selected viahi_res_model_name(oldermodel_nameis deprecated) or theUNSTRUCTURED_HI_RES_MODEL_NAMEenvironment variable; the open-source fallback default isyolox. The hosted Unstructured API docs (choose hi-res model) say its proprietarylayout_v1.1.0is the default there and generally beatsyoloxon bounding boxes and element classification.