From Gramps
Jump to: navigation, search

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.
An Addons Offline Manual is available for review.

The CheckPlaceTitles tool brings up a way for checking current place titles.

A place object needs a name. Title is the legacy content and the top label on Place Editor.

We can let gramps managing the title according our preferences and data : a dynamic and smart display.

  • Data migration : the legacy place title can generate confusions and empty place title should be the default design with auto-title enabled.

The tool

Inconsistency with titles and place name handling.

The pass

One pass will check all place objects whatever type (city, region, country, street, etc.) and will retrieve the current place title, which is related to our preferences set : the displayer. So, we have :

  • one legacy place title, inherited from previous database and place formatting.
  • a dynamic place title, handled by gramps according to our policy, historical data, design, choices and preferences : the auto-title features.

Once a legacy title does not match current auto-title or is not empty, this can generate some frustrations and confusions. So, this one pass tool will list some place objects.


Two columns :

  • the hardcoded and legacy place title, also visible on Place Editor without auto-title support (see Preferences on Display item)
  • the displayed title

Why radio-buttons are checked?

Two status : enable/disable auto-title on Places.

One check :

hard-coded legacy place title =/= place display

According to your preferences, the default selection will either select all entries with differences or only few (place title == place display).

Keep in my mind that the primary goal of the tool was to check place titles for a complete data migration (legacy title to the smart one). Any minor difference between the legacy place title and the automatic displayed one will be detected.

895 entries under 929 may be improved because of inconsistency or duplicated information.

If you had set postal code or an old name for a province, state, building, etc. and now you have more consistency on place names by using place hierarchy, then the pass will list the data.

Seizure and importations

Consistency with free plain text field as single place title, was a challenge. We inherited minor differences by setting textual place values without hierarchy and format features. The tool can also help us to point out some of these minor differences.


You have three options, available at the bottom :

  • clean - remove legacy content for place title
  • copy - copy old place title to a new note.
  • tag - assign a tag and mark place

When the Apply button is clicked, then changes or additions will be made on your selected place objects.

There is also an Help button to see this page.



This article's content is incomplete or a placeholder stub.
Please update or expand this section.

In french

Autotitle enabled. You filled the place name with auto-title support (see Display item into Preferences dialog) but the tool detects a possible issue. checked by default.

Duplicate textual value on legacy field. You disable auto-title support and see that an hard-coded place title exists. It remains from old database model or after some importations. This field might be empty as gramps does well the job.

Lazy textual place value on seizure or after an import. You have inconsistencies on place filling, the free form does not let you properly display an efficient place title, and gramps displayer does a better job. What is the best place value? With or without auto-title and hierarchy support?

The tool will list possible issues, but let you select/unselect lines and use one of the options available.

Go further

If you need advanced features, you should look at Place Cleanup gramplet.

See Also