Skip to content

Export Documents

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.

Record data + Template = one populated label or document block
Populated blocks + Print layout = pages
Pages + preview/export action = PDF
Block 1 · Tissue tag · 3 × 4Block 2 · Specimen label · 2 × 3123Letter · Portrait1Print-layout presetThe sheet: paper, padding, and block orderPage sizeOrientationPage paddingMultiple blocks mode2Template blockPlaces one template on the sheet as a gridTemplateCopiesRows × ColsAuto-fill pageOrder byPage break after3TemplateOne label or tag: its size, sides, and fields[specimen::fieldNumber][taxonomy::scientificName][site::specificLocality]JPO 7299Rattus rattusSulawesi, Indonesia+ recordBlock 1 · Tissue tag · 3 × 4Block 2 · Specimen label · 2 × 3123Letter · Portrait1Print-layout presetThe sheet: paper, padding, and block orderPage sizeOrientationPage paddingMultiple blocks mode2Template blockPlaces one template on the sheet as a gridTemplateCopiesRows × ColsAuto-fill pageOrder byPage break after3TemplateOne label or tag: its size, sides, and fields[specimen::fieldNumber][taxonomy::scientificName][site::specificLocality]JPO 7299Rattus rattusSulawesi, Indonesia+ record
A print-layout preset sets up the sheet; each template block repeats one template in a grid, and every cell is that template filled with one record.
PieceDecidesExample
Document templateWhat one label or block shows, and how it looksA 50 × 20 mm skull tag
Print-layout presetPaper size, margins, grid, ordering, and page breaks40 skull tags per A4 sheet
RecordsThe values that populate the templateThe 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.

  1. Open the project Dashboard menu and select Export documents.
  2. Choose a Layout profile A. If no print layouts exist yet, select Load defaults to add bundled layouts or Manage presets E to create one.
  3. Review the page setup, template blocks, and selected records.
  4. Select Preview C and generate a preview, inspecting the first and last pages.
  5. Enter a File name (optionally turn on Append date) and choose a destination folder on desktop.
  6. Select Export documents D. Once finished, use Share, open the folder, save a copy, or select Export another.

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:

  1. Enter a unique Template name and an optional Description (up to 80 characters).
  2. Choose the Record type: Specimen, Specimen parts, Symbionts, Site, Collecting event, Narrative, or No records.
  3. Choose 1 sided or 2 sided. Two-sided templates keep separate Front and Back designs; switching to one-sided keeps the Back design saved without printing it.
  4. Set width and height to the dimensions of one label, tag, or block—not the paper sheet.
  5. Add text, images, lines, and shapes on the canvas. Select any element to adjust position, size, styling, visibility, locking, and stacking order.
  6. Select Save template (or Save 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.

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:

SettingUse it toExample
Text type and FormatFormat dates, coordinates, numbers, sex symbols, lists, nested tables, or decoded codes17 Feb 2016, ♀, Scrotal
No Content PlaceholderChoose what prints when a field is empty: blank, N/A, None, the field key, or custom text[specimen::preparator??N/A]
Conditional outputBracket, replace, or add text based on field conditions[82.5] for an estimated weight
  • Nested List prints related records (such as specimen parts or personnel) as a table or card list.
  • Encoded Text converts stored numeric codes into labels. Uncertain sex keeps its question mark in every format: Female?, F?, ♀?.
  • Set No Content Placeholder before finalizing layout spacing, because blank space and N/A take different widths.
  • Build conditionals with the Conditional output dialog and preview both a matching and a non-matching record.
  • Replace text rewrites 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.

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 page on 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.

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.

Configure Page size B, Orientation, custom dimensions if needed, and page padding. Page setup describes the physical sheet; the template describes one block.

Add one or more Template blocks. For each block, set:

  • Template: the reusable document template;
  • Copies: copies printed per record;
  • Rows and Cols: 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 by and Direction: 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.

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).
GoalRecommended settings
One full-page documentOne block, 1 row, 1 column, fixed height
Fixed label gridExact rows and columns, Auto-fill page off
Variable narrative sheetDynamic text sizing and Auto-fill page on; preview long records
Multiple copies of each labelIncrease Copies on the block
Two-sided tag2 sided template; verify front/back mirroring
Mixed packetMultiple blocks with Continuous (Block-by-block)
Paired record outputMultiple blocks with Alternate (Record-by-record)

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 font to install a .ttf, .otf, or .ttc file from your device.
  • Select Find fonts to 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.

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 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.

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:

  1. Export specimen records from NAHPU as a .csv file.
  2. Clean the data: spellcheck, fix errors, and combine or split columns as needed.
  3. Load the CSV into Entomolabels (Windows only) with your custom tag template.
  4. Export front and back tag PDFs, then interleave front and back pages.
  5. Print on an auto-duplex printer.

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.

SymptomWhat to check
Placeholder prints literallyCheck the template record type and use the full table::field key.
Conditional prints literallyExpression syntax is invalid—check for missing ]], unquoted values, or mixed && and ||.
Condition never matchesComparisons are case-sensitive, test stored values rather than display labels, and blank values never match ordinary operators.
Preview is emptyCheck the block record type and select matching records.
Template is missingReassign the block or import/restore the named template.
Text overlaps or clipsTurn on dynamic text sizing and Auto-fill page, or enlarge the block.
Unexpected blank spaceCheck fixed rows, template size, page padding, and template padding.
Records out of orderSet Order by and Direction on the block.
Unexpected duplicate labelsCheck Copies and the selected record list.
Blocks in wrong sequenceChange Multiple blocks mode.
Back side missing or rotatedCheck 2 sided, Back content, and mirror settings.
Preview is marked staleRegenerate the preview after your latest edit.
Config import changed many settingsSelected-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.