Bulk Scan

A bulk scan lets you apply the same prompt and field connection to many documents at once. The maximum documents per task depends on your plan — see Plans and billing for each tier's limit. Instead of scanning documents one at a time, you select a set of documents in Nuix Discover's browse list and let Claira work through all of them automatically. This is how you move from prompt testing to production-scale review.

Before you run a bulk scan

You need three things in place before starting:

1. A connected field. In the Claira Settings area, connect the Nuix Discover field where results should be written. If you have not done this yet, see the Fields guide.
2. A saved prompt. Write and save your prompt in the Prompt area. We strongly recommend testing it first with Single Review on a sample of documents. Single review is free on every plan and every media type — bulk scans are the only thing that consume tokens.
3. Selected documents. In Nuix Discover's browse list, select the documents you want to scan. The current selection determines which documents Claira will process.

How to run a bulk scan

1. In Nuix Discover, select the documents you want to scan from the browse list.
2. Open the Claira pane and choose one of these entry points:
   • Go to Bulk Scanning mode.
   • Stay in Prompt Lab mode and use the bulk-start button in the Prompt section.
3. Confirm your prompt and connected field are correct.
4. Review the confirmation details. Claira shows you:
   • The number of documents in your selection
   • Your current scan input mode
   • Your current token balance
   • The estimated token usage for this run
   • The destination field where results will be written. For a Multi-Code run, this row instead shows a Multi-code scan summary with the number of fields that will be written to.
   • The estimated duration for the task
5. Start the task:
   • In Prompt Lab mode, click (shown when more than one document is selected).
   • In Bulk Scanning mode, click .

Monitoring progress

Once the scan starts, you can watch progress in real time within the Claira pane. The progress indicator shows how many documents have been processed out of the total.

There is no need to interact with the interface while the scan runs. Just keep the browser window open and let Claira work through the list.

Where results go

Results populate directly into the connected Nuix Discover field as each document is processed. You do not need to export or transfer anything -- the data flows straight into your existing review workflow.

You can begin reviewing results in Nuix Discover as soon as documents start completing, even while the rest of the task is still running.

Bulk Task History Report

For an audit-friendly record of every bulk task you've run on a case, click the download icon at the top of the Bulk Tasks tab. The PDF contains one card per task with:

• The task number, name, and media type badge (auto, text, image, audio, or video).
• Status, success rate, and the count of succeeded / failed / skipped documents.
• The full prompt text that was sent to the model.
• The customer-facing model name (e.g. "Claira Default (CA)") and the run configuration (temperature, language, destination field).
• Tokens used.

This is the canonical record of what was run on the case — useful for QC reviews, defensibility, or sharing with a client.

Token usage

Token usage depends on the Scan as dropdown selection. The per-document rate is charged only for documents the AI successfully scans — failed, skipped, and pending (cancelled) documents are refunded automatically when the task reaches a terminal state.

• Auto mode (default): 1 to 20 tokens per successful document, set by the mode Claira picks for that document (text=1, image=5, audio=10, video=20). The task reserves the worst-case rate (20 / doc) up front and refunds the difference as each document resolves.
• Text mode: 1 token per successful document
• Image mode (single field): 5 tokens per successful document
• Audio mode (single field): 10 tokens per successful document
• Video mode (single field): 20 tokens per successful document

When Multi-Code is enabled, the per-document cost also depends on the number of active multi-code fields (up to 8). The first field is charged at the per-doc media rate, and each additional field adds 1 token (the source file is fetched once per document and reused for the remaining text-only field calls):

• Text + Multi-Code: 1 token per active field (for example, 3 fields = 3 tokens per document).

• Image + Multi-Code: 5 tokens for the first field plus 1 per additional field (3 fields = 7 tokens per document; 8 fields = 12 tokens per document).

• Audio + Multi-Code: 10 tokens for the first field plus 1 per additional field (3 fields = 12 tokens; 8 fields = 17 tokens per document).

• Video + Multi-Code: 20 tokens for the first field plus 1 per additional field (3 fields = 22 tokens; 8 fields = 27 tokens per document).

• Claira reserves the full task cost upfront and checks your token balance before starting; a scan will not begin if it would exceed your available tokens.

• When the task finishes, any documents that did not complete successfully are credited back to your reservoir as a refund entry on the billing ledger.

• To check your current balance, look at the token count displayed in the bulk scan confirmation dialog or in the Usage popover.

What counts as a successful document

A bulk task processes every document you selected. At the end of the task each document is in one of these states:

• Completed — the AI returned a response. Charged.
• Failed — the AI returned an error, the model could not parse the file, or retries were exhausted. Refunded.
• Skipped — the document type is unsupported in the selected mode or the content is unreadable. Refunded.
• Pending — the task ended (cancelled, abandoned, or terminated for another reason) before the document was scanned. Refunded.

The success / failed / skipped counts are also visible per task in the Bulk Task History Report.

• Keep one saved configuration per workflow to reduce setup drift.
• Record model, template, and field mapping choices in your matter log for auditability.
• When results vary unexpectedly, rerun the same sample before changing multiple settings at once.

Scan-as dropdown (auto / text / image / audio / video)

Bulk scan uses Auto by default — Claira picks the best mode for each document at scan time, so a mixed production gets the right treatment without you needing to sort it first. Auto, Text, Image, Audio, and Video are all available on every plan, including Starter.

• Auto (default): Claira inspects each document and picks Text / Image / Audio / Video on the fly. Bills at the resolved mode's rate per document (1 / 5 / 10 / 20 tokens). Up to 20 tokens / doc is held at task creation; the difference is refunded as each document resolves to a cheaper mode. See Media scans for the full hierarchy.
• Text: Claira sends Nuix extracted text. 1 token/doc (single-field), or 1 per active field in Multi-Code.
• Image: Claira attaches the source image / PDF file. 5 tokens/doc (single-field), or 5 + 1/extra field in Multi-Code.
• Audio: Claira attaches the source audio file. 10 tokens/doc (single-field), or 10 + 1/extra field in Multi-Code.
• Video: Claira attaches the source video file. 20 tokens/doc (single-field), or 20 + 1/extra field in Multi-Code.

What the model receives by mode

• Text mode: Claira sends your prompt plus Nuix extracted text in the request body.
• Image mode: Claira sends your prompt and attaches the source document. Accepted formats: PDF, PNG, JPEG, WebP, GIF, BMP, HEIC, HEIF.
• Audio mode: Claira sends your prompt and attaches the source audio file. Accepted formats: MP3, WAV, AAC, OGG, FLAC, M4A, AIFF.
• Video mode: Claira sends your prompt and attaches the source video file. Accepted formats: MP4, MOV, WebM, AVI, MKV, MPEG, 3GP, FLV, WMV.

If a file section is unreadable or missing, Claira prompts the model to state that limitation and provide best-effort findings.

If a scan fails because of input mode

When a document cannot be scanned in the selected mode, Claira shows an actionable error. Where possible, Claira inspects the document's source files and tells you which mode would work — for example, a Text scan on an audio-only document writes "this looks like audio content — try Audio scan" into the field.

Common examples:

• Source file unavailable or unsupported MIME for the selected mode: switch the Scan as dropdown to a different mode and rerun.
• Extracted text is missing on a Text scan: switch to the suggested media mode (or Image if no suggestion is available).

Next steps

• New to prompting? Start with the Prompting Overview.
• Need media scan details (image / audio / video accepted formats)? See Media scans.
• Want to understand your results? See Understanding Results.
• Encountering errors? Check Error Codes or Troubleshooting.

Need help? Contact us at support@claira.to.