How Box AI Extracts Contract Dates and Amounts Into Metadata

Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How Box AI Extracts Contract Dates and Amounts Into Metadata.
Coding Liquids tutorial cover featuring Sagnik Bhattacharya for How Box AI Extracts Contract Dates and Amounts Into Metadata.

Box AI extracts contract dates and amounts by reading each contract against a metadata template you define, such as start date, end date, notice period and contract value, then writing the values into those fields. Box now packages this as Box Extract. Check results by reviewing low-confidence flags, comparing a sample against the originals and watching usage in AI Units.

The Complete Excel Course with AI Integration

From formulas and pivot tables to Power Query, DAX, VBA and AI with Copilot, ChatGPT and Claude — hands-on from the first lesson.

By Sagnik Bhattacharya and Virginia Thorn, Primetime Emmy Award winner

Buy now

Two cautions before any setup. First, the no-code admin route depends on your Box plan, and the answer is narrower than the marketing suggests. Second, extraction is a first draft of your contract register, not the register. Dates and amounts drive money and legal deadlines, so every automated value needs a way to be checked. The sections below cover plans, template design, field instructions, a trial run, unit costs, a verification sample and a renewal alert, using a craft brewery supplier and a specialist food importer as examples.

Which Box plans can extract metadata with Box AI?

Only Enterprise Advanced can create and run Custom Extract Agents in the Box web app, according to Box's help pages, while the Extract Agent APIs for developers are open to Business plans and above.

Box's help pages describe two routes. The no-code route is Box Extract: you create a Custom Extract Agent in the web app, point it at folders, and it fills metadata on every file. The developer route is the Box AI API, which calls the extract endpoints from your own software. Their availability differs.

WhatPlan, per Box's docsIncluded AI Units a month
Extract Agent APIs (for a developer or integrator)Business, Business Plus, Enterprise, Enterprise Plus, Enterprise AdvancedBusiness and Business Plus: buy them. Enterprise 1,000, Plus 2,000, Advanced 20,000
Create and run Custom Extract Agents; Autofill with the Standard and Enhanced agentsEnterprise Advanced only20,000
Confidence levels and references in Box PreviewEnterprise Advanced onlyUses units when switched on

Box's plan table on its AI documentation also carries a note under the Business column that reads "MDE templates not available", which appears to refer to metadata template extraction, so ask Box to confirm what a Business account can do. This tutorial does not quote an Enterprise Advanced price; ask Box or your account manager for a current quote. If your plan is lower down, the sensible question for your account manager is whether the upgrade is worth it for the contracts you have, rather than assuming extraction is built in.

Why design the metadata template before running Box AI?

Design the metadata template first, because it decides what you get back: Box Extract maps what it reads onto the template's fields. A metadata template is a form attached to files: named fields with types. Admins and co-admins create templates in the Admin Console. Field types available for extraction are Text, Number, Date, Dropdown and Taxonomy.

Two rules from Box's documentation shape the order of work. One metadata template is selected per agent, and once a source folder is attached the template is locked and cannot be changed or replaced. So finish and save the template first. Also, a Custom Extract Agent and an existing metadata cascade policy, or two agents, cannot use the same template on the same folder.

A filled-in template for supplier contracts

Say a craft brewery supplier keeps about 140 contracts with hop growers, packaging suppliers, haulage firms and the lease on the warehouse. The owner wants a register that answers "what ends in the next 90 days, and what auto-renews?" A workable template, with field types, looks like this:

FieldTypeWhy it earns a place
CounterpartyTextSearching and grouping by supplier
Contract typeDropdown: Supply, Haulage, Lease, Service, OtherDifferent notice habits per type
Start dateDateAnchors the term
End date or renewal dateDateThe field the renewal alert runs on
Renews automaticallyDropdown: Yes, No, Not statedAuto-renewal is where money leaks
Notice period (days)NumberTurns an end date into a decision date
Contract value, annualNumberSort by what matters most
CurrencyDropdown: your list of currenciesStops amounts being compared across currencies
Payment terms (days)NumberCash-flow planning
Needs human reviewDropdown: Yes, NoSet by your reviewer, not by the AI

Ten fields keeps you under the 20-field line where Box recommends moving to the Enhanced agent. The final field is deliberate: it gives your reviewer a place to record that a human has checked the row, which becomes your audit trail.

If you would rather not draw the template by hand, Box lets admins generate one from up to 10 sample files. Box says generating a template with Box AI is a paid feature that uses premium models, and the generated field instructions are not saved into the template, so you write your own when you build the agent.

How do you write Box AI field instructions that work?

Write each field instruction as a note to a careful new colleague: where the value usually sits, what format to return, what to do when it is missing, and which edge cases to watch. Box Extract lets you attach a short AI instruction to each field, up to a 5,000-character prompt limit, and Box recommends doing so.

End date or renewal date
Look in the "Term" or "Duration" clause and in any schedule headed
"Renewal". If the contract states a fixed term, return start date plus
that term as a date. If it renews automatically, return the end of the
CURRENT term, not the end of all possible renewals. If an amendment
changes the term, use the amendment. If no end can be found, leave the
field empty. Never guess.

Contract value, annual
Return the annual amount as a number with no currency symbol or commas.
If the contract states a monthly fee, multiply by 12. If it states a
total for a multi-year term, divide by the number of years and say so
in the review column. If prices are per unit with no total, leave empty.

Notice period (days)
Return the number of days' written notice needed to end or not renew.
If given in weeks or months, convert to days (1 month = 30 days).

Notice what these do. They define the ambiguous cases up front (current term versus all renewals, monthly versus annual), they tell the model to leave a field empty rather than guess, and they fix the unit. Without that, a contract value might come back as a monthly figure in one file and a total in the next, and both will look plausible.

Standard or Enhanced agent for contracts

Box offers two extraction agents. Its documentation recommends the Standard Extract Agent for high-volume, structured or semi-structured documents of 50 pages or fewer with fewer than 20 fields, and the Enhanced Extract Agent for complex, large or unstructured documents of 50 pages or more or with more than 20 fields. Box describes the Enhanced agent as using chain-of-thought reasoning, and says you cannot choose the model for it, whereas the Standard agent lets API users pick a model.

For a ten-field template on supply contracts of 5 to 30 pages, Standard is the sensible default. Use Enhanced for the lease and any master agreement with schedules that run past 50 pages. Both consume AI Units, and Box says the number depends on document size, complexity and endpoint, so compare them on your own files rather than assuming.

How do you trial Box Extract before attaching any folder?

Test Extraction in Box Extract runs the agent against up to ten sample files you choose, without applying it to folders, so run it before attaching any folder. The option sits on the agent's configuration page, and Box warns that testing consumes AI Units.

  1. In Box, go to Automate and open the Extract tab, then select New+ and Custom Extract Agent.
  2. Pick up to 10 sample contracts. Choose ugly ones: a scanned copy, a long master agreement, an amended contract, a contract in a currency you rarely use.
  3. Select your saved metadata template, enable the fields, add the AI instructions, and choose Standard or Enhanced.
  4. Set the extraction policy: keep existing metadata values, or override them. Box notes that overriding replaces all existing metadata values. Choose keep, so hand-corrected values survive a re-run.
  5. Switch on Enable references and Enable confidence levels under Configurations, then Advanced. Both are off by default and both cost extra AI Units, but for contract dates they are worth it during the trial.
  6. Select Test Extraction and compare every returned value against the file.

Only then use Add Source Folder. Each agent takes up to 10 source folders, each set to "Selected folders only" or "Selected folders and all subfolders". Box says backfill, meaning processing files already in a folder when you attach it, has no file limit. That is useful, but it also means a single click can spend a month's units, which brings us to cost.

How much does Box AI extraction cost in AI Units?

Box's help pages give no per-document AI Unit figure for extraction, and units depend on document size, complexity and the agent you choose, so open Box's AI Units consumption table and then measure your own cost with a trial run.

Box measures chargeable AI use in AI Units. Extraction in the web app and through the API is chargeable. Box's doc says units are allocated per entitlement period, unused units expire and do not roll over, and consumption from several chargeable features is pooled. At the limit, paid AI features are blocked until the next period or until you buy more, and users see "AI unit entitlement has been reached". Box also says confidence levels, references (bounding boxes) and AI-generated templates use extra units.

Box's help pages give no per-document unit figure; they point to a separate AI Units consumption table, which you should open first. Either way, estimate from your own run, because the units depend on document size, complexity and which agent you choose.

  1. Note your AI Units figure: Admin Console, Home, AI Insights, AI Units card. Box says this card lags by about two hours, so wait before reading it after a run.
  2. Run Test Extraction on your 10 sample files with confidence levels and references on.
  3. Read the card again and subtract. Divide by 10 for units per file.
  4. Multiply by the number of files in the folders you plan to attach, then add a third for re-runs and mistakes.

A worked example with an invented reading. Suppose the 10-file test uses 40 units, so 4 per contract. The brewery supplier's 140 contracts would use about 560 units; add a third for re-runs and the budget is about 750. On Enterprise Advanced's 20,000 monthly units, that is under 4%. On Enterprise's 1,000, it is three quarters of the month, which would block other chargeable AI features. The real figure for your files may be far different, which is exactly why you measure.

Admins can also download a historical AI units report, filterable by date, user and AI capability. Box recommends keeping folder scope tight: fewer scanned files means fewer units.

How do you check the values Box AI extracts from contracts?

Check the values Box AI extracts with three built-in tools (confidence levels, references and Run History) plus a fourth check of your own: a human sample compared against the original contracts.

  • Confidence levels. In Box Preview, if enabled, each value shows LOW (below 0.7) or HIGH (0.9 or above) where Box Extract flags one. If any value is LOW, a banner shows how many fields may need review. You can accept, correct or clear each value.
  • References. Select a field in Box Preview to see where in the document Box found the value. Box lists references as supported for PDF, PNG, JPG and TIFF files.
  • Run History. Box's docs list status, source folder, timestamps and file name for each extraction, and failed extractions show a reason. A separate note in Box's limitations says records are stored temporarily, so do not treat it as a permanent log.
  • A human sample. This one is yours, and it is the one that protects you.

Sampling plan for 140 contracts

These thresholds are my suggestions, not Box's. Pick 20 files, not at random alone: include at least three scans, three amended contracts, the longest contract of each type, and the oldest. Check the five fields that carry money or deadlines: end date, auto-renews, notice period, annual value and currency. That is 100 checks. Record each as correct, wrong or empty.

Field (illustrative results)CorrectWrongEmptyRead
End date1811Fine; review the wrong one
Renews automatically1631Add an instruction about renewal schedules
Notice period (days)1721Check month-to-day conversions
Annual value1541Monthly versus total confusion; tighten the prompt
Currency2000Fine
Total8610486% correct; not ready to rely on

My rule of thumb: do not rely on a field until it is correct in at least 19 of 20 files, and never let an auto-renewal or notice-period field go unreviewed even then, because one wrong notice period costs a year of a bad contract. In the table above, auto-renewal, notice and value all need another round: edit the instruction, re-test the 10 sample files, and re-run the 20-file check. Keep the log, since it shows later how the register was verified.

Where to look hardest

Amounts and dates fail in predictable ways, whichever tool reads them:

  • An amendment that changes the term or price, while the base agreement is what gets read.
  • Dates written as 03/04/2027 where the day-month order is a guess; compare with the signature page.
  • Monthly fees, annual fees and total contract values sitting in the same clause.
  • Mixed currencies in one document, such as a price list in euros and a fee schedule in dollars.
  • Scans with stamps or handwriting over the key clause.

Box says Box Extract currently supports extraction in English, Japanese, Korean, Chinese and Cyrillic, so check your contract languages against that list before you rely on it. For a specialist food importer with agreements in several currencies, the currency field and the "amount per delivery versus per year" distinction deserve their own checks. See can AI review a contract for a wider view of what automated reading misses, and chat-with-PDF tools and client files if the contracts are confidential.

If you check your verification sample in a spreadsheet, try The Complete Excel Course with AI Integration on Coding Liquids.

Can Box remind you before a contract renews?

Partly: once end dates sit in a metadata field, a Box Apps view with notifications and a scheduled Box Relay or Box Automate workflow can build a reminder. Box documents those parts; a trigger that fires a set number of days before a date field was not confirmed when this was written, so design around what is documented.

  • A view in Box Apps. An admin builds a Box App over the template, and views filter on template fields. Create a view called "Ending in the next 90 days" and check the date filter options in the Filters tab for your setup.
  • Notifications on that view. Box Apps lets you select the bell icon, choose a type of change and a frequency of daily, weekly or monthly. Box notes notifications work only for views of up to 1,000 results.
  • A scheduled workflow. Box Relay can start a workflow on a schedule, daily, weekly, monthly or yearly, and can start one when a metadata template is applied to a file, with conditions on its values. Box's docs say Box Automate replaces Relay and adds a metadata event trigger with conditions; check which one your plan includes.

A simple version: a monthly scheduled workflow asks the contract owner to review the "Ending in the next 90 days" view and sets the "Needs human review" field. The decision date is end date minus notice period, so add a second view for that if your Box setup lets you compute it, or have your reviewer add the date by hand. For a tool-agnostic version, how to track contract renewals with AI shows the process, and AI software contracts: auto-renewals and notice periods shows what to watch for in vendor agreements.

The re-run that overwrote a week of corrections

An illustration of why the extraction policy matters. A brewery supplier's office manager spends a week correcting notice periods by hand across the register. A colleague then improves the field instructions, sets the extraction policy to override and re-runs the folder. Box's documentation says overriding replaces all existing metadata values, so every hand correction is replaced by fresh AI output, some of it wrong again.

The protection is cheap: leave the policy on keep existing values while people are correcting, and override only after you have exported or recorded the corrected values. Box also notes that deleting an agent preserves the metadata it already extracted, so a bad agent can be removed without wiping the register.

Permissions, privacy and who owns the agent

Box states that a Custom Extract Agent can only be attached to folders where the agent's owner has Owner, Co-owner, Editor or Viewer Uploader access, and that agents created by end users are private to them and cannot be shared. So decide who owns the agent that runs your register, and make sure it is someone who will still be there next year. Box also says admins can enable Box Extract for all managed users, for selected users and groups, or for everyone except some, so you can limit it to the people who handle contracts.

Finally, remember what the register is for. It speeds up finding and tracking. It is not a substitute for reading a contract before you sign or terminate one, and for anything with legal weight, ask a qualified adviser. If you want to talk through which contract fields are worth the cost, that is the kind of question my AI implementation consultation covers; see the contact page.

Box AI extraction questions from admins

Does Box AI metadata extraction work on every Box plan?

No. Box's documentation says the Extract Agent APIs are available on Business plans and above, while creating and configuring Custom Extract Agents and using Autofill with the Standard and Enhanced Extract Agents is limited to Enterprise Advanced. Business and Business Plus must buy AI Units for the API. Confirm your own plan with Box before planning around the no-code route.

Can Box AI read scanned contracts?

Box's developer docs say the freeform extract endpoint does not support OCR, while the structured endpoint applies OCR automatically to PDF, TIFF, PNG and JPEG files. Box Extract is described as using integrated OCR. Test a handful of your worst scans first, because poor scan quality is the likeliest cause of missed dates and amounts.

Who can create the metadata template?

Admins and co-admins can create metadata templates in the Admin Console, and in Box Extract they can also generate a template from up to 10 sample files or build one manually. Managed users can pick an existing template but cannot create, generate or edit one. Agree the field list with the contract owner before an admin builds it.

Do I need to keep the Enhanced agent for long contracts?

Box recommends the Standard Extract Agent for documents of 50 pages or fewer and fewer than 20 fields, and the Enhanced agent for 50 pages or more or more than 20 fields. A twelve-field template on short supply contracts suits Standard. Test both on a few of your longest files and compare the AI Units each run uses.

Further reads

Show 2 more related tutorials

Sources: Box Docs (Box Extract, Understanding AI Units, Box AI features in business plans, confidence levels, Box Apps and Relay pages), Box support announcement for Box Extract, Box developer docs on the extract endpoints and the Box pricing page (read 17 November 2026).

Want a second pair of eyes on your setup?

Bring the process you're trying to fix. On a 1:1 call we'll work out which AI tools should handle it, which parts stay manual, and how to roll it out without disrupting the team.

Book a 1:1 call with me