M My Own Project — Unofficial Gramps tools and ideas.
Overview Gramps Graph View Profiles Guides Source & Downloads About the author Contact & Q&A

Gramps tool

Verify the Data → HTML report

Run Gramps’ built-in data checks and save the results as a sortable HTML report that can be reviewed item by item.

Purpose

Verify the Data → HTML report runs the same checks as Gramps’ built-in Verify the Data tool.

Instead of displaying the results only in the usual Gramps window, it creates one self-contained HTML file with embedded styling and JavaScript. The finished report opens automatically in your default browser.

The add-on imports Gramps’ own verification class rather than copying the checks. It therefore follows changes and additions made to the built-in tool, while leaving all original Gramps files untouched.

Download and compatibility

Download VerifyTheData-V1.0.zip

  • Designed for Gramps 5.2 or later.
  • The package is configured for Gramps 6.0.
  • For Gramps 5.2, change gramps_target_version in VerifyHTML.gpr.py to 5.2.
  • A ready-to-use Danish translation is included in locale/da/LC_MESSAGES/addon.mo.

Installation

  1. Close Gramps.
  2. Extract the ZIP archive.
  3. Create a folder named VerifyHTML in your Gramps user plugin folder.
  4. Copy VerifyHTML.gpr.py, VerifyHTML.py, README.md and the locale folder into it.
  5. Restart Gramps.

The user plugin folder is normally located here:

  • Windows: %AppData%\gramps\gramps<ver>\plugins\
  • Linux: ~/.gramps/gramps<ver>/plugins/
  • macOS: ~/Library/Application Support/gramps/gramps<ver>/plugins/

The tool appears under Tools → Analysis and Exploration.

Set the thresholds first

The report uses the thresholds from Gramps’ built-in Verify the Data tool, including maximum age, young-parent limits and spacing between children.

  1. Open Tools → Family Tree Repair → Verify the Data.
  2. Set the preferred values.
  3. Click Run so Gramps stores them.

Changing a value and closing the window without running the tool does not save it. This setup only needs to be repeated when you want to change a threshold.

Generate the report

  1. Run Verify the Data → HTML report.
  2. Choose where the HTML file should be saved.
  3. The report opens in your default browser.

The report can be sorted by any column, filtered by severity and searched by name, ID, object type or check text. Reviewed items can be marked with a check mark and temporarily hidden.

Save review progress

Check marks are normally stored by the browser and use a stable key based on the item ID and rule. They can therefore survive when the report is generated again.

Use Save a copy to create a new report with the current check marks embedded. This is the safest way to retain progress or move the report to another device.

When a local file:// report is opened in Chrome, browser storage is not always retained between sessions. In that situation, saving a copy is recommended.

Included report functions

  • Sort by any column.
  • Show all items, errors only or warnings only.
  • Search across report content.
  • Hide reviewed items.
  • Mark individual items as reviewed.
  • Save a copy with the current check marks.
  • Reset all check marks for the family tree.