Use Export documents to generate PDFs from NAHPU records: specimen labels, tissue tags, catalog sheets, field books, and other formatted printouts. For a tabular data file instead, use Export records.
How the pieces fit together
Section titled “How the pieces fit together”Record data + Template = one populated label or document blockPopulated blocks + Print layout = pagesPages + preview/export action = PDF| Piece | Decides | Example |
|---|---|---|
| Document template | What one label or block shows, and how it looks | A 50 × 20 mm skull tag |
| Print-layout preset | Paper size, margins, grid, ordering, and page breaks | 40 skull tags per A4 sheet |
| Records | The values that populate the template | The specimens you select |
Document templates and print-layout presets are saved settings you reuse. Keep one layout per recurring print job—such as museum labels, tissue tags, or field sheets.
Quick export
Section titled “Quick export”- Open the project
Dashboardmenu and selectExport documents. - Choose a
Layout profileA. If no print layouts exist yet, selectLoad defaultsto add bundled layouts orManage presetsE to create one. - Review the page setup, template blocks, and selected records.
- Select
PreviewC and generate a preview, inspecting the first and last pages. - Enter a
File name(optionally turn onAppend date) and choose a destination folder on desktop. - Select
Export documentsD. Once finished, useShare, open the folder, save a copy, or selectExport another.
Create a template
Section titled “Create a template ”For a full walkthrough from blank canvas to printed sheet, see Tutorial 4: Create a mammal voucher tag.
Open Settings > Documents E, switch to Templates, and select Create new template:
- Enter a unique
Template nameand an optionalDescription(up to 80 characters). - Choose the
Record type:Specimen,Specimen parts,Symbionts,Site,Collecting event,Narrative, orNo records. - Choose
1 sidedor2 sided. Two-sided templates keep separate Front and Back designs; switching to one-sided keeps the Back design saved without printing it. - Set width and height to the dimensions of one label, tag, or block—not the paper sheet.
- Add text, images, lines, and shapes on the canvas. Select any element to adjust position, size, styling, visibility, locking, and stacking order.
- Select
Save template(orSave as...for a variation).
Use the template settings button in the editor to change a saved template's name, description, or side count. Renaming automatically updates every print layout that references it.
The template's record type determines which fields and records are offered. For specimen templates, choose the taxon filter before picking taxon-specific fields.
Fill a template with record data
Section titled “Fill a template with record data”Text elements display record values using placeholders such as [specimen::fieldNumber] mixed with fixed text. Use Insert Field rather than typing keys manually:
[taxonomy::genus] [taxonomy::specificEpithet] - [specimen::fieldNumber]Prefer full table::field keys in reusable templates; short keys like [fieldNumber] can resolve to the wrong table when two tables share a column name.
Three text-element settings control formatting:
| Setting | Use it to | Example |
|---|---|---|
Text type and Format | Format dates, coordinates, numbers, sex symbols, lists, nested tables, or decoded codes | 17 Feb 2016, ♀, Scrotal |
No Content Placeholder | Choose what prints when a field is empty: blank, N/A, None, the field key, or custom text | [specimen::preparator??N/A] |
Conditional output | Bracket, replace, or add text based on field conditions | [82.5] for an estimated weight |
Nested Listprints related records (such as specimen parts or personnel) as a table or card list.Encoded Textconverts stored numeric codes into labels. Uncertain sex keeps its question mark in every format:Female?,F?,♀?.- Set
No Content Placeholderbefore finalizing layout spacing, because blank space andN/Atake different widths. - Build conditionals with the
Conditional outputdialog and preview both a matching and a non-matching record. Replace textrewrites values after formatting—ideal for repeated abbreviations, whereas conditionals handle changes driven by another field.
See Export expressions for the complete reference, including Conditional output and Text types and their formats.
Design for real records
Section titled “Design for real records”Test previews with your longest text, largest repeated lists, missing optional fields, and long identifiers—short sample records hide overflow.
For narratives or nested lists:
- turn on dynamic text sizing so text boxes expand as needed;
- turn on
Auto-fill pageon the layout block when block heights vary; - leave adequate wrapping width and printer padding;
- regenerate the preview after any template or layout edit.
For static images, use a managed image path on the device and verify it after importing the template elsewhere; a template JSON stores the reference, not a copy of external image files.
Create a print-layout preset
Section titled “Create a print-layout preset ”Open Settings > Documents and switch to Print layouts. Create a new layout or use Save as... before modifying a working one. Enter an optional description (up to 80 characters) under the preset name and select Update to save both; the description appears in the preset list.
Page setup
Section titled “Page setup”Configure Page size B, Orientation, custom dimensions if needed, and page padding. Page setup describes the physical sheet; the template describes one block.
Template blocks
Section titled “Template blocks”Add one or more Template blocks. For each block, set:
Template: the reusable document template;Copies: copies printed per record;RowsandCols: fixed sheet grid;Auto-fill page: measure each block's actual height instead of using fixed row heights;- template padding: margin around each block;
Order byandDirection: deterministic record sorting;Page break after: force a page break after the block.
If a block shows This template no longer exists, pick a replacement template before previewing or exporting; NAHPU never substitutes one silently.
Multiple blocks
Section titled “Multiple blocks”When a layout contains multiple blocks, Multiple blocks mode controls print order:
Continuous (Block-by-block): prints all records for block 1, then all records for block 2 (best for multi-section packets).Alternate (Record-by-record): prints block 1 and block 2 for record 1, then for record 2 (best for paired outputs that stay together).
Practical layout recipes
Section titled “Practical layout recipes”| Goal | Recommended settings |
|---|---|
| One full-page document | One block, 1 row, 1 column, fixed height |
| Fixed label grid | Exact rows and columns, Auto-fill page off |
| Variable narrative sheet | Dynamic text sizing and Auto-fill page on; preview long records |
| Multiple copies of each label | Increase Copies on the block |
| Two-sided tag | 2 sided template; verify front/back mirroring |
| Mixed packet | Multiple blocks with Continuous (Block-by-block) |
| Paired record output | Multiple blocks with Alternate (Record-by-record) |
Preview and export safely
Section titled “Preview and export safely”Preview runs the exact same template, measurement, and pagination engine as PDF export. Before exporting:
- select representative records for each block;
- inspect both the first and last pages;
- verify long text, repeated lists, grid alignment, padding, and both duplex sides;
- regenerate the preview whenever it is marked stale.
Changes made to the selected layout on the export screen save back to that layout—use Save as... first when testing variations. Exported PDFs are not structured data exports or restorable backups.
Open Settings > Documents > Fonts to manage fonts available to templates, grouped into fonts bundled with NAHPU and fonts you installed. The preview pane shows regular, bold, and italic styles at your chosen size.
- Select
Install fontto install a.ttf,.otf, or.ttcfile from your device. - Select
Find fontsto browse fonts in your browser, then install the downloaded file. You are responsible for font licenses. - Installed fonts stay on this installation and are not transferred with user configs. Install the same font on other devices or pick a replacement when importing a template.
- A font referenced by any saved template cannot be deleted until no template uses it.
Import and share templates and layouts
Section titled “Import and share templates and layouts”Export templates from Settings > Documents > Templates and layouts from Print layouts. Both support Export this ... (single item) and Export all ... (all items) using the same file format, imported through the same Import action. Layout exports include linked templates by default; turn off Include linked templates to export layouts alone.
How conflicts and missing resources are handled on import:
- Duplicate template names: prompts to replace or rename (adding numbered suffixes when importing several at once).
- Duplicate layout names: assigns a non-conflicting name automatically.
- User-config import: replaces selected sections atomically.
- Missing fonts: lists missing fonts and lets you preview and pick replacements before saving, so templates never store unrenderable fonts.
- Static images: referenced by filename only; templates with logos warn on export and require re-adding the image on the target device.
Because layouts reference templates by name, transfer matching templates and layouts together. For a complete device copy including project data and managed files, use Backup database.
Printing specimen tags
Section titled “Printing specimen tags ”Printing tags from NAHPU instead of writing them by hand:
- Saves field time: attach a small temporary tag with key IDs—such as a tissue number (
B-729113) and field number (JPO 7299)—and print full tags later at the museum. - Improves legibility: produces uniform, easy-to-read labels regardless of handwriting.
- Prevents transcription errors: localities, coordinates, and elevations are entered once per site and corrected in one place.
- Allows pre-print curation: clean up coordinates, elevations, terminology, and spelling before printing.
Tag-printing workflow
Section titled “Tag-printing workflow”NAHPU prints tags directly from templates and print-layout presets. When you need specialized external typesetting, you can still pair NAHPU exports with an external label tool:
- Export specimen records from NAHPU as a
.csvfile. - Clean the data: spellcheck, fix errors, and combine or split columns as needed.
- Load the CSV into Entomolabels (Windows only) with your custom tag template.
- Export front and back tag PDFs, then interleave front and back pages.
- Print on an auto-duplex printer.
Printing equipment
Section titled “Printing equipment ”- Printer: The NAHPU team has used the Epson WorkForce Pro WF-3820 with DURABrite® Ultra instant-dry pigment ink, printing over 1,000 bird specimen tags (spring 2024) for the Louisiana State University Museum of Natural Science.
- Paper: 100% cotton, acid-free 250 gsm paper. Because this stock is thick and rigid, gently flex sheets before loading so the duplexer flips pages reliably.
Archive the printed output
Section titled “Archive the printed output”Keep the generated PDF—and the template and layout presets needed to reproduce it—with your project archive. Inspect a test printout before running a full batch, print on durable archival stock, and store physical copies with the collection records. Printed documents never replace a database backup, project export, or structured record export; see Archiving a project.
Troubleshooting
Section titled “Troubleshooting”| Symptom | What to check |
|---|---|
| Placeholder prints literally | Check the template record type and use the full table::field key. |
| Conditional prints literally | Expression syntax is invalid—check for missing ]], unquoted values, or mixed && and ||. |
| Condition never matches | Comparisons are case-sensitive, test stored values rather than display labels, and blank values never match ordinary operators. |
| Preview is empty | Check the block record type and select matching records. |
| Template is missing | Reassign the block or import/restore the named template. |
| Text overlaps or clips | Turn on dynamic text sizing and Auto-fill page, or enlarge the block. |
| Unexpected blank space | Check fixed rows, template size, page padding, and template padding. |
| Records out of order | Set Order by and Direction on the block. |
| Unexpected duplicate labels | Check Copies and the selected record list. |
| Blocks in wrong sequence | Change Multiple blocks mode. |
| Back side missing or rotated | Check 2 sided, Back content, and mirror settings. |
| Preview is marked stale | Regenerate the preview after your latest edit. |
| Config import changed many settings | Selected-section user-config import replaces each selected section (except Custom fields, which merge). |
Every template editor control is documented under Export expressions. For developer-level architecture details, see Templates and presets and Export workflows.

