Appendix C. Filter rules reference

Table of Contents

General filters
Event filters
Family filters
Ancestral filters
Descendant filters
Relationship filters
Miscellaneous filters

This appendix lists of all the filter rules currently defined in GRAMPS. Each of these rules is available for use when creating custom filters, see the section called “Custom Filter Editor”. The rules are listed by their categories.

General filters

This category includes the following most general rules:

Has complete record

This rule matches all people whose records are marked as complete. Currently, the completeness of personal information is marked manually, in the Edit Person dialog.

People with incomplete names

This rule matches all people with either given name or family name missing.

Is bookmarked person

This rule matches all people who are on the bookmark list.

Has text matching substring of

This rule matches all people whose records contain specified substring. All textual records are searched. Optionally, the search can be made case sensitive, or a regular expression match.


This rule matches any person in the database. As such it is not very useful on its own except for testing purposes. However, it may be useful in combinations with other rules.

People probably alive

This rule matches all people whose records do not indicate their death and who are not unreasonably old, judging by their available birth data and today's date.

Has a name

This rule matches any person whose name matches the specified value in full or in part. For example, Marta Ericsdotter will be matched by the rule using the value "eric" for the family name.

Separate values can be used for Given name, Family name, Suffix, and the Title. The rule returns a match if, and only if, all non-empty values are (partially) matched by a person's name. To use just one value, leave the other values empty.

Has the Id

This rule matches any person with a specified GRAMPS ID. The rule returns a match only if the ID is matched exactly.

You can either enter the ID into a text entry field, or select a person from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Is default person

This rule matches the default (home) person.

People marked private

This rule matches people whose records are marked as private.

Is a female

This rule matches any female person.

People who have images

This rule matches people with images in their galleries.

People without a birth date

This rule matches people missing birth date.

Is a male

This rule matches any male person.