Semi-structured Document Classification

• Published on May 6, 2026
• 6 minute(s) read

Classification models in Hyperscience

Classification models are a crucial part of document processing as they help the system determine which layout should be used to process each page you upload. In Hyperscience, we have two types of document classification:

Semi-structured Document Classification - Automatically classifies documents that don’t follow a consistent layout pattern (e.g., invoices, bank statements, etc.).

Structured Document Classification - Automatically classifies documents that follow a consistent layout pattern (e.g., tax forms, standardized applications) by assigning them to the correct layout in Hyperscience. To learn more, see Structured Document Classification.

In this article, you’ll learn when and how to use Semi-structured document classification.

How it works

Semi-structured classification is handled by the Non-Structured Layout Classifier (NLC), which relies on the words in the document to predict the most likely layout group. Note that the NLC works on a page-level.

For each page, the model outputs a confidence score that reflects its certainty about the classification. This score is then compared against the configured Target Accuracy Threshold:

• High-confidence matches - the document is classified automatically.
• Low-confidence matches - behavior depends on your flow configuration:
  • If Manual Classification is enabled, low-confidence pages can trigger a Document Classification Task for manual review. Learn more about the Document Classification task in Structured Document Classification.
  • If Manual Classification is disabled, low-confidence pages are marked as No Layout Found.

This approach ensures that high-confidence predictions are automated, while low-confidence cases get the necessary human validation to maintain Accuracy. To learn more about target accuracy, see our Accuracy article.

Semi-structured Classification Grouping Logic

When classifying Semi-structured documents, the system needs to decide how to group consecutive pages that are matched to the same layout. This behavior is controlled by the Semi-structured Classification Grouping Logic setting in your flow. Learn more in Document Processing Subflow Settings.

You can choose between three options:

• Consecutive pages as a document - All consecutive pages classified to the same layout are grouped together into a single multi-page document.
• Consecutive pages as separate documents - Each page classified to the same layout is treated as a separate document, even if the pages are consecutive.
• Manual review of consecutive pages - The system flags consecutive pages for human review, allowing users to manually confirm whether they should be grouped into one document or kept separate. Ensure that the Manual Classification Supervision setting is enabled in your flow. Learn more in Document Processing Subflow Settings

By default, the flow-level grouping logic inherits the grouping configuration defined at the layout level. To learn more, see Auto-Splitting.

Releases and Classification models

Each release in Hyperscience contains a set of layouts. Learn more in our What is a Release? article.

When you create a new release, the system automatically generates a new for all Semi-structured and Additional layouts in that release.

• If a new release contains the same combination of Semi-structured and Additional Layouts as an existing release, it reuses the existing Classification Model
• If the release introduces a new set of Semi-structured or Additional layouts, a new model is created automatically.
• Adding or removing Structured layouts has no impact on model compatibility.

Over time, as you add layouts and retrain, your Semi-structured Classification model evolves to handle a wider range of documents.

Training the Classification model

To classify Semi-structured and Additional layouts accurately, the system needs to be trained on examples of these documents. Training Data comes from three sources:

• Submitted documents - Pages already matched to a layout, whether classified by the machine or by a user. These pages have been processed and passed QA.
• Training Data Management - Documents you add directly from the Classification Model detail page.
• “Excluded” documents - Pages used to train the model on what not to classify. This reduces unnecessary manual effort by keeping irrelevant documents out of processing.

Model performance depends on how close new submissions are to the training data:

• If documents differ significantly (e.g., new invoice formats), add training pages and retrain the model.
• If changes are unexpected, Continuous Model Improvement (if enabled) helps the model adapt automatically, though automation may temporarily dip after deployment of a new model. Learn more about Continuous Model Improvement in Application Settings Overview.

To maintain accuracy, a percentage of classified documents is sampled for Classification QA. These tasks ask users to confirm that the model’s predictions are correct and are required for reporting automation and accuracy.

Well-trained models reduce manual workload. If the model isn’t trained enough, more pages fall below the threshold and generate Supervision tasks.

In rare cases, the model may make high-confidence mistakes, which can be flagged as incorrect during any ID or Transcription Supervision task. To learn more, see the Reprocessing section of Structured Document Classification article.

• Adding training pages for these cases improves future performance.
• Blank Pages - Pages with little text are automatically marked as Blank.

Learn more about improving the model’s performance in Model Validation Tasks.