Output Length Control: Word Caps vs Section Slots (Prompt Table)
The first draft came back at 1,400 words for a two-page template that holds 700, and the revised draft came back at exactly 600 with the operating limits section missing. Volen Pumps writes 60 datasheets a year across a catalogue of 74 pump models, and both drafts were a control failure wearing the costume of a length problem.
There are two families of instruction for this, and they behave differently under pressure. A word cap states a total and lets the model decide what to sacrifice. A section slot states the structure and lets the words fall where the structure says they belong. Choosing between them is a decision about which failure you can tolerate, so the table below scores five controls against a datasheet workflow. The output structure guide covers the template side of the same problem.
Length Control Comparison Table
| Control | Precision | Best for | Observable failure |
|---|---|---|---|
| Hard word cap, one number | High on total, zero on distribution | Standalone answers with no required sections | A required section vanishes and the total still matches |
| Range cap with a priority order | Medium | Summaries where something may be dropped | Model protects the easy sections and truncates the hard one |
| Fixed section slots, no word budget | Low on total, high on structure | Datasheets, spec sheets, compliance forms | Every section inflates, total reaches 1,600 words |
| Section slots with per-slot budgets | High on both | Anything printed to a fixed page count | Model pads the short slot to hit its number |
| Bullet and character counts | Very high per item | Feature lists, error messages, UI strings | Reads like a telegram, no connective reasoning |
The decision starts with one question: will a human notice if a section is missing? If yes, never use a total word cap alone, because a cap has no opinion about which 600 words survive. If the answer is no, a cap is faster to write and easier to check.
What a Word Cap Actually Measures
A cap measures tokens generated, not information delivered. Ask for 600 words and you get 600 words, but the model has no way to know that the pressure rating matters more than the paint finish. At Volen, the 600-word draft that omitted the operating limits passed a length check and failed a technical review, which is the worst combination: the error surfaces two days later, in front of a customer.
Caps also fail at the low end. Below roughly 200 words, models start compressing nouns into compounds and dropping articles, and the result reads like a parts list rather than a sentence. If your target is that short, you want a slot with a character budget, not a cap.
Write the product description for Volen Pumps model VX-40, a close-coupled centrifugal pump for chilled-water loops. Hard limit: 600 words, counted on the body text only, excluding the heading. Before writing, rank these four elements by importance for a specifying engineer: flow range, efficiency at part load, seal options, paint and finish. If the limit forces a cut, drop from the bottom of that ranking and tell me in one line what you dropped. Do not shorten the operating limits section under any circumstance.Note the last sentence. A cap becomes usable when you add one immovable constraint to it. Without that, the cap is a budget the model spends wherever it likes.
Prompts for Slots, and for the Hybrid
Pure slots. The template is the instruction. Seven headings, no totals, and the model fills each one at whatever length the content demands.
You are writing a two-page datasheet for Volen Pumps model VX-40. Use exactly these headings, in this order, and do not add or merge any: Application, Performance Range, Construction, Operating Limits, Options, Installation Notes, Ordering Code. Write each section as continuous prose, no bullet lists except under Options. Do not state a total word count and do not summarise at the end.Slots with budgets. This is the control Volen settled on for its 42 standard models. Each heading carries a ceiling, and the ceilings add to a number that fits two printed pages with the drawing and the performance curve.
Write the VX-40 datasheet using the fixed sections below. Respect each ceiling exactly and do not redistribute words between sections. Application: 90 words. Performance Range: 70 words plus a 5-row table (flow, head, efficiency, power, NPSH). Construction: 110 words. Operating Limits: 80 words. Options: 6 bullets, max 14 words each. Installation Notes: 100 words. Ordering Code: 1 line plus 4 field definitions, max 12 words each. If a section cannot be written within its ceiling, keep the section and cut detail, then list what you cut at the end under a heading called CUTS.Repair pass. When a draft overshoots, do not ask for a rewrite. Ask for a diff, so the writer can see what changed.
Here is a datasheet draft that runs 1,180 words against a 700-word budget. Do not rewrite it from scratch. Produce a table with one row per sentence you propose deleting, showing the section, the sentence, the word count, and the reason it is safe to remove. Then output the shortened version with deletions marked in square brackets so I can restore any of them.Where Each Control Breaks
The cap breaks by omission. Something has to go, and the model picks the section it understands least. On a pump datasheet that is usually Operating Limits, because it contains the numbers a writer is most likely to have supplied in a dense block.
The slot breaks by inflation. With seven headings and no ceilings, every section drifts upward by 15 to 20 percent, and the total lands at 1,500 words with nothing obviously wrong in any single paragraph. This is the failure that survives review, because each section reads fine in isolation.
The hybrid breaks by padding. Once a section has a number, the model fills to it. An 80-word Operating Limits section with 50 words of content gets 30 words of restatement. Volen’s fix was to allow a section to finish early and require a one-line note when it does, which turns underfill into a visible signal instead of a silent one.
Measure which failure you have before changing the prompt. Count sections per draft, words per section, and the gap between the largest and smallest draft of the same model. If the variance sits in one section, the slot is wrong. If it sits in the total, the cap is being ignored.
Matching the Control to the Document Type
The 60 datasheets are not one genre. Forty-two are standard catalogue sheets with stable content, and those take slots with budgets because the layout never changes. Twelve are custom-engineered sheets for a single customer, where the section order is fixed but the length genuinely varies with the scope, so they take slots without ceilings and a human page check. Six are safety and compliance sheets, where no length control should exist at all: the text is dictated by a standard, and a word cap would be an error.
That split is worth writing down, because it stops the argument about prompts and turns it into a routing rule. A new document arrives, someone assigns it to a genre, and the genre carries the prompt. Volen keeps the three prompts in a shared document with the template, and the structured JSON output prompt is useful when the same content has to feed both the print template and the website spec table.
Then check the control itself. Take ten past datasheets, run each through the current prompt, and compare word counts per section against the printed originals. If the prompt consistently overshoots one heading, the ceiling is unrealistic rather than the model being disobedient. The evaluation loop in our prompt evaluation workflow is the right frame for that comparison, and it takes about an hour for a template this fixed.
Sources & Notes
Volen Pumps, the 60 datasheets, the 74-model catalogue, and the 1,180-word draft are an illustrative scenario, not a real manufacturer. Section names are generic on purpose so they map onto most industrial templates. Word ceilings depend on your page size, typeface, and drawing area, so derive them from a printed page rather than from a round number. If a document is governed by a safety standard, treat the standard as the length authority and skip these controls entirely.
