Skip to content

Settings

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.

KindExamplesTransfer behavior
Project informationName, accession, location, time zone, dates, project Field ID valuesIncluded in project-info and project transfers
Shared database recordsTaxa and personnelStored in the NAHPU database and associated with projects
User configsControlled vocabularies, field visibility, custom-field definitions, and export or document presetsTransferred with Export user configs and Import user configs
Installation stateTheme, language, regional format, dashboard tools, and active catalog formatStays 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.

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 with Match 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 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 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, and Datums.

Events C configures collection event forms:

  • Primary Activities G: defaults to Collecting, Recording, and Observing (Other is not included unless you add it).
  • Collection Methods and Personnel 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 D configures specimen capture, numbering, controlled vocabularies, and symbionts:

  • Capture records: turn Always show collector field on or off.
  • Numbering: configure Field ID, Tissue ID, and (when Ichthyology is active) Individual tag ID, described below.
  • Sex: restricted controlled vocabulary. Male, Female, and Unknown are always available. Use the + chips to add Gynandromorph, Hermaphrodite, Female?, or Male? (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, and Conditions.
  • Symbionts (for Mammalogy, Ornithology, Herpetology, and Ichthyology): configure Identification (Symbiont ID prefix and Symbiont ID number) and editable default vocabularies for Interaction types, Categories, Detection Methods, Preparation Methods, Anatomical Locations, Storage, and Treatments. See Symbionts.

Under Field ID, choose how new specimens are numbered:

ChoiceBuilt fromRequires
Personnel ID (default)The Cataloger's initials and running numberA person with the Cataloger role in the project, with initials and a current field number
Project IDPrefix + Current catalog number + SuffixAn 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 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 E adds your own fields to site, environmental, specimen, part, and symbiont forms.

SettingOptions
TypeText, Number, Yes / No, or Dropdown
ScopeCurrent project (this project only) or Global (every project on this device), chosen at creation
CatalogSpecimen-related fields can be limited to selected catalog formats
Darwin Core mappingOptional export term for the field
  1. Open the project if the field is project-scoped, go to Settings > Custom fields, choose where the field appears, and select Add custom field.
  2. Enter a Label and choose a Type. For a dropdown, add the allowed options. For a number field, include the unit in the label (such as Canopy height (m)).
  3. Choose the Scope and, for specimen-related fields, the applicable catalog formats.
  4. Optionally set a Darwin Core mapping. NAHPU does not validate values against the mapped term, so inspect a sample export before sharing data.
  5. Save, enter a test value on a record in that section, and reopen the record to confirm it saves properly.
  6. 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:

  • Archive hides a field while keeping its stored data; Restore brings it back.
  • Delete appears as Delete (values in use) and stays unavailable while any record holds a value.
  • Discard legacy values clears legacy values separately and cannot be undone.
  • Taxa F manages taxonomy records available to projects.
  • Personnel manages people in the database and their specimen-care roles.
  • Backup database saves a full ZIP or TAR.GZ archive of all projects, records, managed media, and settings.
  • Replace database restores a NAHPU backup archive (ZIP or TAR.GZ) or SQLite file (.sqlite3). NAHPU shows a side-by-side comparison before overwriting and leaves Back up current data first turned on by default.
  • Tabular Data manages reusable presets for exporting tabular records.
  • Documents manages print-layout presets, document templates, and fonts available to templates.
  • Template Editor creates 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.

These preferences apply only to this installation.

SettingWhat it does
ThemeSwitches between Light, Dark, and System.
LanguageSets the app language (System default or a specific language). In beta.
Regional formatControls how dates and numbers display on screen (Match language or a region). Saved records and exports keep standard formats. In beta.
ToolsChooses which tools appear in the project dashboard dock. Use Reset to restore defaults.
Data usageReports storage usage and cleans up unlinked files, described below.

Open Data usage to scan NAHPU-managed folders. The summary shows Total usage, Files, Media files, and Reclaimable space from unlinked files.

  • Remove unlinked files deletes 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 from Documents > Fonts instead.
  • The Files tree 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, or Select 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.
  • Rescan refreshes the report if files changed outside NAHPU.

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.