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.
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.
Installation
- Close Gramps.
- Extract the downloaded ZIP archive.
-
Copy or extract the project folder into your Gramps user plugin folder.
Keep the complete folder structure unchanged, including any `locale` folder included with the project.
The user plugin folder is normally located here:
- **Windows:** `%AppData%\gramps\gramps(version)\plugins\`
- **Linux:** `~/.gramps/gramps(version)/plugins/`
- **macOS:** `~/Library/Application Support/gramps/gramps(version)/plugins/`
Replace `(version)` with the Gramps version folder used on your system.
Start Gramps again. -
Check that the installed filter, rule, gramplet or tool is available where described in the project documentation.
If the project does not appear or fails to load, check **Help → Plugin Manager** for an error message.
Removing the test version
- Close Gramps.
- Delete the project folder that you added to the Gramps user plugin folder.
-
Start Gramps again.
Because the project was installed only in the user plugin folder, removing that folder removes the test installation without changing the original Gramps program files.
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.
- Open Tools → Family Tree Repair → Verify the Data .
- Set the preferred values.
- 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
- Run Verify the Data → HTML report .
- Choose where the HTML file should be saved.
- 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.