Introducing s-1: Sievly’s new document reading model

All posts

Engineering

Layout-first chunking: why we split by structure, not tokens

Fixed-size chunks cut tables in half and separate headers from their rows. Here is how Sievly decides where one idea ends and the next begins.

Rafael Ström

·

Machine Learning Engineer

sievly

Layout-first chunking

Retrieval quality depends on what goes into each chunk. Most pipelines split text every few hundred tokens, which is simple and wrong for real documents.

The problem with fixed windows

A fixed window does not know that a table is one unit, that a caption belongs to its figure, or that a heading sets the context for the paragraphs below it. Splitting through those boundaries creates chunks that look fine alone and mislead a model in context.

Reading structure first

Sievly builds a layout tree for every page: sections, headings, tables, figures, lists and running text. Chunks follow that tree, so a table travels with its header row and a figure with its caption.

What it means for retrieval

Answers come back with the context that makes them true. We publish the chunking options in the API so you can tune size and overlap for your own retrieval setup.

Start building with your own documents.

sievly

Sievly is the document platform for AI teams that need dependable accuracy on real-world files, at any volume.

Sievly, Inc. © 2026

Get Sievly updates by email

Product notes and new releases from the Sievly team, in your inbox.

Unsubscribe anytime. Privacy Policy

sievly

sievly

Sievly is the document platform for AI teams that need dependable accuracy on real-world files, at any volume.

Sievly, Inc. © 2026

Get Sievly updates by email

Product notes and new releases from the Sievly team, in your inbox.

Unsubscribe anytime. Privacy Policy

sievly

sievly

Sievly is the document platform for AI teams that need dependable accuracy on real-world files, at any volume.

Sievly, Inc. © 2026

Get Sievly updates by email

Product notes and new releases from the Sievly team, in your inbox.

Unsubscribe anytime. Privacy Policy

sievly

Create a free website with Framer, the website builder loved by startups, designers and agencies.