Large screen
Small screen
Settings control how NAHPU works on this device: catalog formats, controlled vocabularies, custom fields, presets, and app preferences.
Open Settings from the home screen menu or from a project's Dashboard menu. To configure project-scoped custom fields or a project's Field ID values, open that project first. To walk through initial device setup step by step, use Setup NAHPU from the home screen menu.
What each setting affects
Section titled “What each setting affects”| Kind | Examples | Transfer behavior |
|---|---|---|
| Project information | Name, accession, location, time zone, dates, project Field ID values | Included in project-info and project transfers |
| Shared database records | Taxa and personnel | Stored in the NAHPU database and associated with projects |
| User configs | Controlled vocabularies, field visibility, custom-field definitions, and export or document presets | Transferred with Export user configs and Import user configs |
| Installation state | Theme, language, regional format, dashboard tools, and active catalog format | Stays on this device |
Controlled vocabularies, presets, and installation preferences are shared by every project on this device. Changing them while one project is open also affects other projects on the same installation.
Catalogs
Section titled “Catalogs ”Across Sites, Events, and Specimens, settings work in two consistent ways:
- Controlled vocabularies let you add or remove choices, set a text case format (
A), or pull existing values from your records withMatch database. - Field-visibility toggles only show or hide built-in fields on forms; hiding a field never deletes values already stored in the database.
Format
Section titled “Format ”Format A sets the active catalog format for new specimen forms and measurement fields on this device. A single project can still hold specimens from more than one taxon group.
When Mammalogy is selected, Measurement records also offers Always show bat fields so bat-specific fields always appear on mammal measurement forms instead of being toggled per specimen.
Sites
Section titled “Sites ”Sites B configures site forms and coordinate maps:
Map layers: choose a base layer or import and arrange custom layers (GeoJSON, zipped WGS84 Shapefiles, and PMTiles).Geography fields: choose which geography fields appear on site forms.- Controlled vocabularies: manage
Site Types,Habitat Types, andDatums.
Events
Section titled “Events ”Events C configures collection event forms:
Primary ActivitiesG: defaults toCollecting,Recording, andObserving(Otheris not included unless you add it).Collection MethodsandPersonnel Roles: controlled vocabularies for methods and event roles.Environmental data fields: choose which temperature, humidity, measurement, aquatic, astronomy, and note fields appear on event forms. Forms start with ambient temperature, ambient humidity, cloud cover, rainfall, and notes.
Transfer user configs to keep these vocabularies identical across field devices.
Specimens
Section titled “Specimens ”Specimens D configures specimen capture, numbering, controlled vocabularies, and symbionts:
Capture records: turnAlways show collector fieldon or off.- Numbering: configure
Field ID,Tissue ID, and (whenIchthyologyis active)Individual tag ID, described below. Sex: restricted controlled vocabulary.Male,Female, andUnknownare always available. Use the+chips to addGynandromorph,Hermaphrodite,Female?, orMale?(a question mark records examiner uncertainty). An added option can be removed only when no specimen in the database uses it.- Controlled vocabularies: manage
Identification Methods,Life Stages,Specimen Types,Treatments, andConditions. Symbionts(forMammalogy,Ornithology,Herpetology, andIchthyology): configureIdentification(Symbiont ID prefixandSymbiont ID number) and editable default vocabularies forInteraction types,Categories,Detection Methods,Preparation Methods,Anatomical Locations,Storage, andTreatments. See Symbionts.
Field ID
Section titled “Field ID ”Under Field ID, choose how new specimens are numbered:
| Choice | Built from | Requires |
|---|---|---|
Personnel ID (default) | The Cataloger's initials and running number | A person with the Cataloger role in the project, with initials and a current field number |
Project ID | Prefix + Current catalog number + Suffix | An open project, the three values, and whether Auto-increment catalog number is on |
With Project ID, NAHPU joins the three values directly: NAHPU-, 120, and -M produce NAHPU-120-M. Select Save field ID settings to apply changes.
Tissue ID
Section titled “Tissue ID ”Tissue ID takes a prefix, a next number, and a suffix, and shows a live preview of the next tissue ID. Leading zeros are preserved, so M0042-T is followed by M0043-T.
When the active catalog format is Ichthyology, Individual tag ID numbers individuals in a fish lot the same way. See Fishes.
Custom fields
Section titled “Custom fields ”Custom fields E adds your own fields to site, environmental, specimen, part, and symbiont forms.
| Setting | Options |
|---|---|
| Type | Text, Number, Yes / No, or Dropdown |
| Scope | Current project (this project only) or Global (every project on this device), chosen at creation |
| Catalog | Specimen-related fields can be limited to selected catalog formats |
| Darwin Core mapping | Optional export term for the field |
- Open the project if the field is project-scoped, go to
Settings>Custom fields, choose where the field appears, and selectAdd custom field. - Enter a
Labeland choose aType. For a dropdown, add the allowed options. For a number field, include the unit in the label (such asCanopy height (m)). - Choose the
Scopeand, for specimen-related fields, the applicable catalog formats. - Optionally set a Darwin Core mapping. NAHPU does not validate values against the mapped term, so inspect a sample export before sharing data.
- Save, enter a test value on a record in that section, and reopen the record to confirm it saves properly.
- To share definitions with another device, export them from
Custom fields(as a file or QR code) or with user configs, then import and verify the section, scope, and options on the target device.
Use the actions menu on an existing field to reorder it (Move up / Move down), archive it, or delete it:
Archivehides a field while keeping its stored data;Restorebrings it back.Deleteappears asDelete (values in use)and stays unavailable while any record holds a value.Discard legacy valuesclears legacy values separately and cannot be undone.
Database
Section titled “Database ”TaxaF manages taxonomy records available to projects.Personnelmanages people in the database and their specimen-care roles.Backup databasesaves a full ZIP or TAR.GZ archive of all projects, records, managed media, and settings.Replace databaserestores a NAHPU backup archive (ZIP or TAR.GZ) or SQLite file (.sqlite3). NAHPU shows a side-by-side comparison before overwriting and leavesBack up current data firstturned on by default.
Exports
Section titled “Exports ”Tabular Datamanages reusable presets for exporting tabular records.Documentsmanages print-layout presets, document templates, and fonts available to templates.Template Editorcreates and edits document templates.
Choose Load defaults from the options menu—or from an empty preset list—to add bundled presets. Presets that work with any catalog format start checked; catalog-specific presets start unchecked and are also offered in Setup NAHPU. Loading defaults never overwrites an existing preset with the same name, and any preset can be deleted.
Export these presets as user configs when another installation needs the same columns, labels, or layouts.
Applications
Section titled “Applications ”These preferences apply only to this installation.
| Setting | What it does |
|---|---|
Theme | Switches between Light, Dark, and System. |
Language | Sets the app language (System default or a specific language). In beta. |
Regional format | Controls how dates and numbers display on screen (Match language or a region). Saved records and exports keep standard formats. In beta. |
Tools | Chooses which tools appear in the project dashboard dock. Use Reset to restore defaults. |
Data usage | Reports storage usage and cleans up unlinked files, described below. |
Data usage and cleanup
Section titled “Data usage and cleanup ”Open Data usage to scan NAHPU-managed folders. The summary shows Total usage, Files, Media files, and Reclaimable space from unlinked files.
Remove unlinked filesdeletes files no longer used by any record, such as leftovers from deleted media or cancelled imports. Linked files, databases and backups, custom fonts, map layers, and files outside NAHPU-managed folders are never affected. Remove installed fonts fromDocuments>Fontsinstead.- The
Filestree lets you expand or collapse folders (Expand all/Collapse all), inspect stored files, save a copy, remove empty folders, or remove eligible files one by one. - Multi-file cleanup: choose
Select, then pick individual files, folders, orSelect all. Use the bottom toolbar (Clear,Review,Done) to check the count, size, and locations before exporting the selection to an archive (with an option to remove the originals afterward) or deleting the files permanently. Rescanrefreshes the report if files changed outside NAHPU.
Transferring user configs
Section titled “Transferring user configs ”Both Export user configs and Import user configs are available from the home screen menu, the project Dashboard menu, and Setup NAHPU—not inside the Settings page.
A user-config transfer lets you pick which sections to share (controlled vocabularies and field visibility, record-export presets, document templates and layouts, and custom fields) without replacing the project database. Review imported configs before replacing your current setup, and see Export user configs for full steps.


