Gramps 4.2 Wiki Manual - Categories
![]() |
Special copyright notice: All edits to this page need to be under two different copyright licenses:
These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links. |
Previous | Index | Next |
![]() |
This page's factual accuracy may be compromised due to out-of-date information. Please help improve the Gramps Wiki as a useful resource by updating it. |
Genealogical information is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.
Contents
- 1 Categories of the Navigator
- 2 Dashboard Category
- 3 People Category
- 4 Relationships Category
- 5 Families Category
- 6 Charts Category
- 7 Events Category
- 8 Places Category
- 9 Geography Category
- 9.1 The different views
- 9.2 Usage
- 9.2.1 The configuration
- 9.2.2 How to zoom and move around the map ?
- 9.2.3 The mouse actions on the map
- 9.2.4 The menu popup
- 9.2.5 Click on a marker
- 9.2.6 Adding or Linking to a place
- 9.2.7 Adding places from kml files
- 9.2.8 How to change the map provider ?
- 9.2.9 Can we change the marker's color ?
- 9.2.10 How to get/remove the crosshair ?
- 9.2.11 How to lock/unlock the map ?
- 9.3 Prerequisites to see the geography view
- 9.4 Possible problems
- 10 Sources Category
- 11 Citations Category
- 12 Repositories Category
- 13 Media Category
- 14 Notes Category
- 15 Web Category
The different Categories of the Navigator: The navigator is located at the left of the window and allows selection of the different categories (See: Fig. ?.?)
Dashboard: Displays different general purpose Gramplets, small widgets that can help in your genealogical research.
People: Displays the people in the family tree without their connections. This Category contains the PeopleListView and the PeopleTreeView.
Relationships: Shows the relationships between the Active Person and other people in a textual way. This includes parents, spouses, and children.
Families: Shows the families in the family tree.
Charts: Displays graphical trees for the selected person.
Events: Displays the events in the family tree.
Places: Displays the places in the family tree.
Geography: Displays data of your family tree on a map.
Sources: Displays the sources in the family tree.
Citations: Displays the citations in the family tree.
Repositories: Displays the repositories in the family tree.
Media: Displays the media objects in the family tree.
Notes: Displays the notes in the family tree.
The categories can contain several ways of presenting the data. Each specific way is called a View. Before we launch into a description of each View, let's first explain how to switch between Views.
Dashboard Category
This contains the Dashboard, which shows a number of widgets, called Gramplets, that can help you in your research. Two Gramplets are shown on start-up (the Welcome and Top Surname Gramplets). By right-clicking on the Gramplet View, a popup comes up with the possibility of adding other Gramplets.
- Age on Date Gramplet - see the people alive and their ages on a particular date
- Age Stats Gramplet - see age span graphs
- Attributes Gramplets - see active person's attributes
- Calendar Gramplet - see people's events on a particular date, or in a month in the past
- Descendants Gramplet - see the active person's descendants
- Fan Chart Gramplet - see the active person's pedigree, in a circular fan chart
- Given Name Cloud Gramplet - most popular given names
- Pedigree Gramplet - see a complete pedigree in compressed text
- Quick View - run a Quick View on the current person
- Records Gramplet - see world's records of your data
- Relatives Gramplet - see the relatives of the active person
- Session Log Gramplet - keep track of what you have done, and what records you have visited
- Statistics Gramplet - see stats on the database
- Surname Cloud Gramplet - most popular surnames as a "text cloud"
- To Do Gramplet - a notepad to keep tabs on your research
- Top Surnames Gramplet - top 10 most popular surnames
- Welcome Gramplet - a Gramps welcome message
- What's Next Gramplet - what needs to be done next
In addition, there are a number of additional Gramplets that you can easily install and use. These include:
- Headline News Gramplet - current, breaking news from Gramps
- Data Entry Gramplet - edit active person's name, birth date and place, death date and place, and add people
- Python Gramplet - a Python shell
- FAQ Gramplet - frequently asked questions
- Note Gramplet - see and edit active person's primary Person Note
and many others. See Third-party Plugins for more details.
For more detailed information on using the installed Gramplets, see Gramplets.
People Category
The People View lists the people stored in the database. People are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator (eg: +). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.
By default, the People View List, displays several columns of information about each person.
Relationships Category
The Relationships Category displays all the relationships of the Active Person (the selected person). Specifically, it shows his or her parents, siblings, spouses, and children.
The Relationships Category is designed to allow for quick navigation. You can quickly change the Active Person simply by clicking the name of any person listed on the page. Each name is actually a hypertext link, similar to a web page.
The name of the Active Person is in bold style. Other names are shown either with or without bold and italic emphasis depending on whether certain relationships exist for the named person. For a person listed as a parent or spouse of the Active Person, the name is emphasized if that person has a parent family. For a person listed as a sibling or child of the Active Person, the name is emphasized if that person has children.
Dates are normally in regular style, and in italic style if the displayed event is a fallback event, i.e., a substitute event for another missing event. That may be christening event for birth event, burial event for death event, etc.
The Relationships Category displays the following sections:
Active Person
- At the top of the screen, name, ID, birth, and death information, as well as the calculated age of the Active Person is displayed.
- On the right hand side a photo of the person if available, will be shown. You can click on the photo to open it in the default picture viewer.
- Next to the person's name is a symbol indicating gender, and an
Edit button. Clicking the
Edit button will allow you to edit all of the person's individual information in an Edit Person dialog.
Parents
The Parents section, displays the families in which the person is a child. Since it is possible for a person to have multiple sets of parents, it is possible to have several Parents sections.
You can control how much information is displayed by using the View menu. The view menu allows you to show or hide details (the birth and death information) and to show or hide siblings. Next to each person listed is an Edit button, which will allow you to edit all the details of that particular person.
You may add a set of parents by either selecting the Add Parents or the Share Parents buttons. The Add Parents button will create a new family with the Active Person listed as a child. The Share Parents button will allow you to choose from a list of existing families, and then add the person as a child to that family.
You may edit an existing parents by selecting the Edit button next to the parents. If you select the - button next to a set of parents, then the Active Person will be removed as a child from the parents. This button does not delete the parents' relationship.
Family
Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible to have multiple families, it is possible to have multiple Family sections. Each family section displays the spouse and any children.
You may add a family by selecting the Add Spouse button in the toolbar. This will create a new family with the Active Person listed as a father or mother.
Selecting the Edit button next to the spouse will allow you to edit the displayed family. Clicking the - button will remove the person from the displayed family.
![]() |
Removing a person from a family Removing a person from a family does not delete the family. The person is removed as the father or mother, and any other relationships in the family continue to exist. |
You can reorder the parents and spouses by selecting the Reorder button. This option will only be enabled if more than one set of parents or more than one set of spouses exists for the Active Person. Selecting this button will display a dialog that will allow you to reorder the families.
Configuration
You can configure the view from the display by calling up the Configure dialog from the menu View -> Configure... or click on the toolbar Configure View... button.
Families Category
The Families List Category View displays a list of all families in the database(see Fig. 4.7). From this view, you may add, edit, or delete families. The default display lists the ID, Father, Mother, Relationship and Marriage Date. Children cannot be displayed on the screen in this view.
Charts Category
The Charts Category shows several graphical representations of the ancestry or descendants of the active person. By default Gramps shows the Pedigree View; With the Fan Chart View and Descendant Fan View being selectable from the toolbar. Installation of additional downloadable addons contain extra views.
Pedigree View
The Pedigree View shows up to five generations, depending on the size of the window. Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk * sign), death information (indicated by a plus + sign), a black stripe across the top left corner of the box if the person is deceased (or determined by Gramps to be no longer alive) and optionally an image if available. Two lines branch from each box. The top one shows the person's father and the bottom one the mother. Solid lines represent birth relations, while dashed lines represent non-birth relations such as adoption, step-parenthood, guardianship, etc.
To the left of the Active Person is a left arrow button. If the Active Person has children, clicking this button expands a list of the Active Person's children. Selecting one of the children makes that child the Active Person.
The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.
Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.
The right-hand side of the window shows two right arrow buttons. When the top button is clicked, the Father of the Active Person becomes the Active Person. When the bottom button is clicked, the Mother of the Active Person becomes the Active Person.
Right-clicking on any person's box in the Pedigree View will bring up the "context menu".
Among other useful items, the context menu has sub-menus listing Spouses , Siblings , Children , and Parents of that person.
"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.
![]() |
Screencasts You can see videos for adding or editing a family (parents, children, siblings) from Pedigree View. Both videos show Gramps 3.2.5 so the current version of Gramps may be slightly different. |
Fan Chart View
This view shows the ancestry but as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person. A second click brings the chart back to the original form. Right click brings up a context menu like in the pedigree view, allowing to navigate to other people.
This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.
You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.
- The view can be a circle, a halfcircle or a quadrant of a circle. The last are always attached to the bottom or side of the view
- Children of the center person are shown with a nice children ring at the center
- Drag and drop people to the center to change the active person
- Color options
- Colors of the boxes based on the age of the people
- Colors of the boxes depending on the time period the person lived in
- White, classic, gender based, and user defined colors
- Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute blue eyes, ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
- Show up to 11 generations in the view.
- Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the print button be printed or saved as svg (to edit further in Inkscape and view in eg Firefox), pdf or ps.
- The font used can be selected and becomes automatically smaller to fit the boxes. On a dark color, the font is white, otherwise black
To understand all, watch the screencast
Descendant Fan View
Events Category
Events can be shared between multiple people and multiple families. The Events View lists the all the events recorded in the database.
The columns available for display are: Description , ID , Type , Main Participants , Date , Place and Last Changed.
The default view displays the Description , ID , Type , Date and Place of the event. The Column Editor dialog can be used to add, remove and rearrange the displayed columns. This can be accessed from the Configure View... button on the toolbar.
The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.
Places Category
The Places Views lists the geographical places in which the events of the database took place. These could be places of birth, death, and marriages of people, as well as their home, employment, education addresses, or any other conceivable reference to the geographical location. The Places View lists the places' Name , Title , ID , Type , Code , Latitude , Longitude , Private , Tags , and Last Changed . All of these columns can be used for sorting by clicking on a column heading.
Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog may be used to add, remove and rearrange the displayed columns.
Map Service
If a place has been highlighted, you may select the Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ... button to attempt to display the place in a web browser.
From the Select a Map Service drop down list you can choose the map service you want to use from the following three options:
- OpenStreetMap(default)
- GoogleMaps
- EniroMaps
Your default web browser should open, attempting to use either the longitude and latitude coordinates or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.
This feature is limited, and may not always produce the results you desire.
Place Tree View and Place List View
The two views in this category show the places grouped or ungrouped. The Place Tree View groups the places in a hierarchy: country, county, ... .
The Place List View on the other hand just shows all the places in one long list.
Geography Category
![]() |
Note The Geography category is only present if OsmGpsMap is present that Gramps can use. |
This category is for showing data on a map. It contains the Geographic View, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).
The Geographic View can:
- show all places in your family tree
- show all places connected to the active person
- show all places connected to the active family
- show all places connected to all events
- show all places connected to a filtered selection of events
- Show if two people have been able to meet
- Show if two families have been able to meet
- Show all displacements or moves for one person and their descendants
These options are accessible via the buttons on the toolbar. To filter on places or events, activate the filter sidebar via the menu View->Filter Sidebar
To have these views working correctly, you need to have events related to places. These places must have coordinates : latitude and longitude.
If one place has no coordinates, we'll never see it on the map.
If you have internet active, for all moves on the map, all zoom ... all tiles are saved. When you are without internet, all tiles cached in a previous session can be used. So, the map can be used without internet and all already visited places can be shown again. The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.
![]() |
BE CAREFUL it can takes gigabytes. If you use several maps, you need to have this same gigabytes size multiply by the number of map used. |
The different views
Usage
The configuration
Via the toolbar Configure View... button (or via the menu View)
All views
- Where to save the tiles of the map (default is $HOME/.gramps/maps). Be careful, it can take several gigabytes.
- The zoom level when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used
- Use keypad for shortcuts. Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard.
Specific views
See the description of the view.
How to zoom and move around the map ?
Zoom in and Zoom out the map
To zoom, you can use :
- The +/- buttons on the top left of the map
- The scroll mouse.
- The "+" or "-" key on the keypad (default).
You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.
Move around the map
To move around the map, you can :
- Clic on the map, then drag it.
- Use the arrows.
The mouse actions on the map
The right button below is for one right handed person. This will be the left button for one left handed person.
button 1 ( left button )
You have two usages for the button 1 :
- The marker selection.
- Valid the region selection
button 2 ( middle button )
The only usage for this button is to select an area on the map.
- when pressed : start the region selection
- when released, end the region selection.
You must use the button 1 to validate the selected region when finished.
button 3 ( right button )
Only one usage for this button.
- show the menu popup.
The mouse over a marker
When the mouse is placed over one marker, we display the place name in the status bar.
From this menu, you have the following functions available for views :
- hide or show the crosshair
- lock or unlock the zoom
- change the default map (provider)
- add a place and link a place at the mouse position
- add a place from kml file
- center the map at the mouse position.
- remove all tiles already uploaded for the current provider
Click on a marker
We have two cases :
- events : For each event, we can edit this event or center the map on this place.
- places : For each place, we can edit this place or center the map on this place.
When centering the map, the zoom used is defined in the geography preferences.
We may have several markers in the click area depending on the zoom. In this case, We show for each marker all related events and/or places. We obtain a mix between the two cases described above.
Adding or Linking to a place
For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select Add place or Link place
When you add a place or try to link a place to the position of the mouse, you'll get a place selection in a region. You'll see on the map a circle in which you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row.
Another way to set latitude and longitude :
- Download the Place completion tool via the Addons manager. If you download the data of your country, this tool can add latitude-longitude to all your places.
Adding places from kml files
For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select Add place from kml
You will get a file chooser. Select the file you want to add. If you have several places in the same kml file, you will get one place editor for each place. Be careful.
How to change the map provider ?
We have several available providers in gramps. Click on the right button of the mouse, you'll get a popup menu. In the bottom of this menu, you can select a new provider. The following providers are avalible :
- OpenStreetMap (default) : The advantage of OpenStreetMap is that it is a free project, so you can update the maps yourself with missing information via their website.
- Maps For Free
- OpenCycleMap
- Public Transport
- Google street
- Google sat
- Google hybrid
- Virtualearth street
- Virtualearth sat
- Virtualearth hybrid
![]() |
Some maps are not free, please read the map provider Terms of Service : Google street, Google sat, Google hybrid, Virtualearth street, Virtualearth sat, and Virtualearth hybrid Remember virtualearth is now bing maps |
Can we change the marker's color ?
We can't do that. The marker's colors are hard coded in gramps. The colors are green for the following renderers : openstreetmap, Maps for free, Opencyclemap and Public transport. All others are red.
How to get/remove the crosshair ?
It can be useful to have the crosshair visible to see the center of the map. This functionality is available with the right button of the mouse. you'll get a popup menu. Select Add or Remove cross hair. This is usefull to add or link places to the correct latitude-longitude coordinates
How to lock/unlock the map ?
When we change the map ( person to family, ... ), the zoom is recalculated. It can be useful in some case to keep the same zoom and position when we change the map provider. For this, click on the right button of the mouse, you'll get a popup menu. In this menu, you can select lock or unlock zoom and position.
Prerequisites to see the geography view
For gramps 4.x, you need to install osmgpsmap version 1.0 and above and the associated gir package.
For example on ubuntu, you must have : gir1.2-osmgpsmap-1.0 and libosmgpsmap-1.0-0
Possible problems
- No view : do you have osmgpsmap installed ? (gramps -v may help you)
- No tiles : do you have an internet connection active ?
- No tiles for one provider : if other providers are OK, file a bug
- Missing tiles : you have no internet connection and it's the first time you try to show the current place.
- Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
- Other : file a bug
Sources Category
Sources View lists the sources of certain information stored in the database.
There are two views in this category. The default (Citation Tree View) shows all the sources, and for each it allows the user to see the Citations associated with that source by clicking on the disclosure triangle. The alternative view only shows the Sources.
Sources can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. Gramps gives you the option to provide a citation to a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the Title , ID , and Author of the source, as well as any Publication information that may be associated with it.
The list of Sources can be sorted by clicking on a column heading.
Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog can be used to add, remove and rearrange the displayed columns.
Citations Category
Citation View lists the citations for certain information stored in the database.
Citations specify which parts of a source are relevant to the information in the database. For example, a Source may be a book, and the citation may be a particular page in the book. Gramps gives you the option to provide a citation for each event you record (births, deaths, marriages, etc.). The Citations View lists the Volume/Page , ID , and Date of the citation, as well as any Confidence in the evidence.
The list of Citations can be sorted by clicking on a column heading.
Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog can be used to add, remove and rearrange the displayed columns.
Repositories Category
A repository can be thought of as a collection of sources.
Each source in the database can reference a repository (such as a library) in which it belongs. The functionality of the Repositories View is similar to the other views.
Media Category
The Media View is a list of Media Objects used in the database.
Media Objects are any files that relate somehow to the stored genealogical data.
Technically, any file can be stored as a Media Object.
Most frequently, these are images, audio files, animation files, etc. The list box on the bottom lists the Name , ID , Type , and Path of the Media Object.
The Column Editor dialog may be used to rearrange the displayed columns, which obey usual sorting rules. The bottom part of the Gramps window shows a preview (if available) in the "Preview" tab and information about the Media Object is available from the other tabs.
In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.
Notes Category
A Note is pure text, as stored in the other objects.
The functionality of the notes View is similar to the other views. The view lists all Notes stored in the Family Tree. Using the menu View ->Configure View... you open the Column Editor and you can change the displayed columns. The possibilities are Preview, ID, Type, Private, Tags and Last Changed.
The Type can be (amongst others): Event Note, Address Note,Source text, Place Note
Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and background color. A spellchecker is available for English and your local language.
By selecting two notes you can use Edit > Merge... from the menu to merge them.
Web Category
![]() |
Note By default the Web Category is normally hidden. The Web Category is called the Html View in the Plugin Manager. |
In order to make the Web Category/Html View available:
- You must ensure that the webkit module is available. (???)
- Once you have started Gramps with the webkit module available, you can go into Help ->Plugin Manager, find the Html View item,select it and click on Hide/Unhide.
- You must then quit Gramps and start it up again.
- When you have done this, the new Web Category will appear.
The Html View (Web) category allows you to browse web pages from within Gramps.
Simply type the web address, and the page will be displayed in the normal way.
Previous | Index | Next |