Gramps 6.0 Wiki Manual

This is the Wiki Manual for Gramps version 6.0. All users are encouraged to edit this manual to help improve its readability and usability.

Research, organize and share your family tree with Gramps.

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.

Abstract

This Gramps Wiki Manual for version 6.0 is the online user's guide, detailing most aspects of the Gramps application, a database for the collection of genealogical information. As of Monday, 6 July 2026, the most current Gramps release is the 6.0.8 version. Both Gramps and the accompanying Wiki Manual have been translated into multiple languages.

You can also download the Complete 5.1 Offline Manual (English 20 MiB PDF and additional languages) last updated 27 Aug 2023. For previous Wiki Manuals revisions, see the archival versions made for previous releases of Gramps. (Search the page for "download" to find offline versions.)

The 6.0 Addons Offline Manual is available for review at (English 18 MiB PDF) last updated 10 Jun 2024.

To explore other sources of information about using Gramps, see the Information Portal.

Table of Contents

Preface

Why use Gramps?

Typographical conventions in the Gramps Wiki Manual

---

A Visual Guide to the Gramps Interface

---

1. What's new?
   1. Before you upgrade
   2. Visible changes to the core
      1. Data Model
      2. Primary changes
      3. GUI
      4. Place
      5. Reports, Tools, Gramplets
      6. Import/Export
      7. New Addons
   3. Under the hood changes
      1. Dependencies
   4. Further information
      1. Miscellaneous
      2. Localization
      3. Roadmap
      4. Changelog

         ---

2. Getting started
   1. Overview
      1. Connections
      2. Privacy
      3. GEDCOM
   2. Start Gramps
      1. Linux
      2. MS Windows
      3. macOS
   3. Choosing a Family Tree
   4. Tell me how to start right now!
   5. Obtaining Help

      ---

3. Main Window
   1. Main Window
      1. Window Title Bar
      2. Menubar
         1. Pull-down menus
         2. Pop-up menus
         3. Selector Combo Boxes
      3. Toolbar
      4. Navigator
      5. Display area
      6. Status Bar and Progress Bar
      7. Bottombar and Sidebar
         1. Gramplet Bar
            1. Bottombar
            2. Sidebar
         2. Gramplet Bar Menu
            1. Restore to defaults? dialog
         3. Search Bar
   2. Switching Navigator modes
      1. Category navigator mode (default)
      2. Expander navigator mode
      3. Drop-Down navigator mode
   3. Switching Categories
   4. Switching Views
   5. Filters

      ---

4. Categories
   1. Categories of the Navigator
   2. Dashboard Category
      1. Gramplet Layout
   3. People Category
      1. Tree View - Grouped People
      2. People List View
      3. People Category Bottombar tabs
         1. Details
         2. Gallery
         3. Events
         4. Children
         5. Citations
         6. Notes
         7. Attributes
         8. References
      4. People Category Sidebar tabs
         1. Filter
   4. Relationships Category
      1. Relationships Category view
         1. Active Person
         2. Parents
            1. Select Family selector
            2. Siblings
         3. Family
            1. Reorder Relationships dialog
            2. Children
         4. Configuration
      2. Relationships Category Bottombar tabs
      3. Relationships Category Sidebar tabs
   5. Families Category
      1. Families Category Bottombar tabs
         1. Details
         2. Gallery
         3. Events
         4. Children
         5. Citations
         6. Notes
         7. Attributes
         8. References
      2. Families Category Sidebar tabs
         1. Filter
   6. Charts Category
      1. Pedigree View
         1. Pedigree View Context menus
            1. Pedigree View Person Context menu
            2. Pedigree View Blank Context menu
         2. Configure the active view
      2. Fan Chart View
         1. Configure the active view
      3. Descendant Fan View
         1. Configure the active view
      4. 2-Way Fan View
         1. Configure the active view
      5. Charts Category Bottombar tabs
      6. Charts Category Sidebar tabs
         1. Filter
   7. Events Category
      1. Events View
      2. Events Category Bottombar tabs
         1. Gallery
         2. Citations
         3. Notes
         4. Attributes
         5. References
      3. Events Category Sidebar tabs
         1. Filter
   8. Places Category
      1. ⚙ Configuration Options
      2. Places List View
      3. Places Tree View
      4. Map Service
      5. Places Category Bottombar tabs
         1. Details
         2. Location
         3. Gallery
         4. Events
         5. Citations
         6. Notes
         7. References
      6. Places Category Sidebar tabs
         1. Filter
   9. Geography Category
      1. The different views
         1. All known places
         2. All known places for one Family
         3. Have they been able to meet ?
         4. All places related to Events
         5. All known places for one person
            1. All known places for one person with graphical information (KML files)
         6. Every residence or move for a person and any descendants
         7. Have these two families been able to meet ?
      2. Usage
         1. The configuration
            1. All views
            2. Specific views
         2. Print or save the Map
         3. How to zoom and move around the map ?
            1. Zoom in and Zoom out the map
            2. Move around the map
         4. The mouse actions on the map
            1. button 1 ( left button )
            2. button 2 ( middle button )
            3. button 3 ( right button )
            4. The mouse over a marker
         5. The menu popup
         6. Click on a marker
         7. Adding or Linking to a place
         8. Adding places from KML files
         9. How to change the map provider ?
         10. Can we change the marker's color ?
         11. How to get/remove the crosshair ?
         12. How to lock/unlock the map ?
      3. Prerequisites to see the geography view
      4. Possible problems
      5. Geography Category Bottombar tabs
      6. Geography Category Sidebar tabs
      7. Filter
   10. Sources Category
       1. Citation Tree View
       2. Sources List View
       3. Sources Category Bottombar tabs
          1. Gallery
          2. Notes
          3. References
       4. Sources Category Sidebar tabs
          1. Filter
   11. Citations Category
       1. Citations List View
       2. Citations Category Bottombar tabs
          1. Gallery
          2. Notes
          3. References
       3. Citations Category Sidebar tabs
          1. Filter
   12. Repositories Category
       1. Repository List View
       2. Repository Category Bottombar tabs
          1. Details
          2. Notes
          3. References
       3. Repository Category Sidebar tabs
          1. Filter
   13. Media Category
       1. Media List View
       2. Media Category Bottombar tabs
          1. Preview
          2. Citations
          3. Notes
          4. Attributes
          5. Image Metadata
          6. References
       3. Media Category Sidebar tabs
          1. Filter
   14. Notes Category
       1. Notes List View
       2. Notes Category Bottombar tabs
          1. References
       3. Notes Category Sidebar tabs
          1. Filter

             ---

5. Manage Family Trees
   1. Starting a new Family Tree
      1. Family Trees manager window
         1. Database information dialog
   2. Opening a Family Tree
      1. Load Family Tree button
      2. Connect to a recent database
         1. Could not load a recent Family Tree. warning
      3. Read Only Mode
   3. Saving changes to your Family Tree
   4. Opening a GEDCOM or XML database
   5. Deleting a Family Tree
      1. Remove the <XXXXXXXX> Family Tree? dialog
   6. Renaming a Family Tree
   7. Backing up a Family Tree
      1. Backup dialog
   8. Archiving a Family Tree
   9. Extracting a Family Tree Archive
   10. Unlocking a Family Tree
       1. Break the lock on the "Family Tree name" database? dialog
       2. The database is locked dialog
          1. Command Line:Force unlock option
   11. Repairing a damaged Family Tree
   12. Converting a BSDDB Family Tree to SQLite
   13. Importing data
       1. Import Family Tree dialog
       2. GRAMPS V2.x database import
          1. Moving a Gramps 2.2 databases to Gramps 3.x
       3. Gramps XML and XML Package import
       4. Gramps CSV import
       5. GEDCOM import
          1. GEDCOM Encoding dialog
          2. Import Statistics dialog
          3. GEDCOM import report dialog
             1. Reading the report
          4. GEDCOM import limitations
             1. HEADer, SUBMitter and SUBmissioN
             2. INDIvidual
             3. FAM_RECORD
             4. SOURCE_RECORD
             5. REPOSITORY_RECORD
             6. MULTIMEDIA_RECORD
             7. NOTE_RECORD
   14. Exporting data
       1. Export Assistant dialog
          1. Saving your data
          2. Choose the output format
          3. Export options
             1. Filters and privacy
                1. Privacy Filter:
                2. Living Filter:
                3. Person Filter:
                4. Note Filter:
                5. Reference Filter:
             2. File format specific export options
          4. Select save file
          5. Final confirmation
          6. Summary
          7. Comma Separated Values Spreadsheet(CSV) export
       2. GEDCOM export
       3. GeneWeb export
       4. Gramps XML (family tree) export
       5. Gramps XML Package (family tree and media) export
       6. Web Family Tree export
       7. vCalendar export
       8. vCard export

          ---

6. CSV Import and Export
   1. Gramps Spreadsheet Import/Export
   2. Export
   3. Import
      1. People
      2. Marriage
      3. Family
      4. Place
   4. Details
      1. Example CSV with multiple areas
      2. Example CSV from Spreadsheet

         ---

7. Probably Alive
   1. How does Gramps determine if someone is alive?
   2. Probably Alive Proxy
   3. Probably Alive Filter
   4. Calendar Gramplet

      ---

8. Entering and editing data: brief
   1. To add or edit a person
      1. Add a new person
      2. Edit an existing person
   2. To specify a relationship
      1. Specifying a relationship using the Relationship View
      2. Specifying a relationship using the Family List View
   3. To specify parents
   4. To specify children
   5. Adding photos and other media objects
   6. To edit events, sources, places, and repositories

      ---

9. Entering and editing data: detailed

   ---

   1. Entering and editing data: detailed - part 1
      1. Editing information about people
         1. Person Editor dialog
         2. Preferred name section
         3. Multiple Surnames
         4. General section
            1. Gender
               1. Unknown gender specified dialog
            2. ID
            3. Tags
            4. Privacy
         5. Preferred image
         6. Edit Person tab pages
            1. Events
               1. Select Event selector
            2. Names
            3. Source Citations
            4. Attributes
            5. Addresses
            6. Notes
               1. Select Note selector
            7. Gallery
               1. Select Media Object selector
            8. Internet
               1. Internet Address Editor
            9. Associations
               1. Person Reference Editor
                  1. Select Person selector
            10. LDS
            11. References
      2. Editing information about relationships
         1. Family Editor dialog
            1. Select Father selector
            2. Select Mother selector
         2. Family Editor tab pages
            1. Children
               1. Select Child selector
               2. Child Reference Editor
                  1. Source Citations tab
                  2. Notes tab
            2. Events
            3. Source Citations
            4. Attributes
            5. Notes
            6. Gallery
            7. LDS
               1. LDS Ordinance Editor
      3. Editing dates
         1. Date selection dialog
         2. Date validity indicators
         3. Date Quality
         4. Date formats and parsing rules
         5. Calendars
            1. Swedish calendar
         6. Dual-dated dates
            1. Alternate new year day

               ---

   2. Entering and editing data: detailed - part 2
      1. Editing information about events
         1. New Event dialog
         2. New Event tab pages
            1. Source Citations
            2. Notes
            3. Gallery
            4. Attributes
            5. References
      2. Editing event references
         1. Event Reference Editor dialog
            1. Reference Information
               1. Reference Information tab pages
                  1. General
                  2. Notes
                  3. Attributes
            2. Shared Information
               1. General
               2. Source Citations
               3. Attributes
               4. Notes_3
               5. Gallery
               6. References
      3. Editing information about media objects
         1. New Media dialog
         2. New Media tab pages
            1. Source Citations
            2. Attributes
            3. Notes
            4. References
      4. Editing media object references
         1. Select a media object selector
         2. Media Reference Editor dialog
            1. Top section
               1. Top section tab pages
                  1. General
                  2. Source Citations
                  3. Attributes
                  4. Notes
            2. Shared Information
               1. Shared Information tab pages
                  1. General
                  2. References
                  3. Source Citations
                  4. Attributes
                  5. Notes
      5. Editing information about places
         1. Place Editor dialog
         2. Place editor tab pages
            1. Enclosed By
               1. Select Place selector
               2. Place Reference Editor
            2. Alternative Names
            3. Source Citations
            4. Notes
            5. Gallery
            6. Internet
            7. References
         3. Place Name Editor dialog
         4. Supported longitude/latitude formats (for coordinates)
      6. Editing information about sources
         1. New Source dialog
         2. New Source tab pages
            1. Notes
            2. Gallery
            3. Attributes
            4. Repositories
               1. Select Repository selector
            5. References
      7. Editing source citations
         1. Select Source or Citation selector
         2. New Citation dialog
            1. Citation information
               1. Select Source selector
               2. Citation information section tab pages
            2. Shared source information
      8. Editing information about repositories
         1. New Repository dialog
         2. New Repository tab pages
            1. Addresses
            2. Internet
            3. Notes
            4. References
      9. Editing information about notes
         1. New Note editor dialog
            1. Note tab
            2. References tab
            3. Link Editor
         2. Note markup and preformat in reports

            ---

   3. Entering and editing data: detailed - part 3
      1. Name Editor
         1. Name Editor dialog
            1. Type
            2. Given Name(s) Section
            3. Family Names Section
         2. Name Editor tab pages
            1. General
            2. Source Citations
            3. Notes
      2. Attributes
         1. Attribute Editor dialog
         2. Attribute Editor tab pages
            1. Source Citations
            2. Notes
      3. Addresses
         1. Address Editor dialog
         2. Address Editor tab pages
            1. Source Citations
            2. Notes
      4. Merging records
         1. Merge People
         2. Merge Families
         3. Merge Events
         4. Merge Sources
         5. Merge Citations
         6. Merge Places
         7. Merge Media Objects
         8. Merge Repositories
         9. Merge Notes

            ---

10. Navigation
    1. Using the People Category
    2. Using the Relationships Category
    3. Using the Families Category
    4. Using the Charts Category
    5. Using Gramplets
    6. Setting the Home Person
    7. Setting the Active Person
    8. Using history-based tools
    9. Bookmarks
    10. Finding records
        1. Jump to by Gramps ID
    11. Using the Clipboard
        1. Clipboard context menu
    12. Using the Addon Manager...
        1. Addon Manager...
           1. Addons
           2. Settings
              1. Available Gramps Updates for Addons
           3. Projects
    13. Main Menus
        1. Family Trees
        2. Add
        3. Edit
        4. View
        5. Go
        6. Bookmarks
        7. Reports
        8. Tools
        9. Windows
        10. Help

            ---

11. Plugin Manager
    1. Plugin types
    2. Registration and loading
    3. Hide/Unhide
    4. Actions
       1. Registered Plugins
       2. Loaded Plugins
    5. Detailed Info dialog

       ---

12. Gramplets
    1. What is a Gramplet
       1. General Usage and Configuration
       2. Summary of Gramplets
          1. Gramplet List
    2. Gramplets
       1. 2-Way Fan Chart
       2. Age on Date
       3. Age Stats
       4. Ancestors
       5. Attributes
       6. Calendar
       7. Children
       8. Citations
       9. Descendant Fan Chart
       10. Descendants
       11. Details
       12. Events
       13. Events Coordinates
       14. Fan Chart
       15. FAQ
       16. Filter
       17. Gallery
       18. Given Name Cloud
       19. Image Metadata
           1. The interface
              1. Data Fields
              2. Buttons
           2. Prerequisites
           3. Usage scenario
       20. Locations
       21. Notes
       22. Pedigree
       23. Preview
       24. Quick View
       25. Records
       26. References
       27. Relatives
       28. Residence
       29. Session Log
       30. SoundEx
           1. Soundex what is this?
       31. Statistics
       32. Surname Cloud
       33. To Do
       34. Top Surnames
       35. Uncollected Objects
       36. Welcome
       37. What's Next

           ---

13. Reports - Index and Summary.

    ---

    1. Generating Reports
       1. Report Settings
       2. Report Format Style

          ---

    2. Substitution Values
       1. The Substitution Keys
          1. Other Substitution Keys
          2. Default displayed formats
          3. Deprecated variables
       2. Format Strings
          1. Formatting names
          2. Formatting Dates
          3. Formatting Places
          4. Rules for format strings
       3. Control Variables
       4. Grouping
          1. Rules for groups
          2. Examples
       5. Attributes
       6. Events
          1. Event format strings
          2. Notes for attributes and events
       7. Separators

          ---

    3. Books
       1. Manage Books dialog
          1. Book name
             1. Book name toolbar
          2. Available items
          3. Available items selections
             1. Alphabetical Index
             2. Custom Text
             3. Table of contents
             4. Title Page
          4. Current book
             1. Current book toolbar
       2. Generate Book dialog
          1. Paper Options
          2. Document Options

             ---

    4. Graphical Reports
       1. Common options
          1. Paper Options
          2. Document Options
       2. Ancestor Tree
          1. Tree Options
          2. Display
          3. Size
          4. Include
       3. Calendar
          1. Report Options
          2. Content Options
          3. Text Options
       4. Descendant Tree
          1. Tree Options
          2. Display
          3. Replace
          4. Size
          5. Include
       5. Family Descendant Tree
          1. Tree Options
          2. Display
          3. Replace
          4. Size
          5. Include
       6. Fan Chart
          1. Report Options
       7. Statistics Charts
          1. Report Options
          2. Charts 1
          3. Charts 2
       8. Timeline Chart
          1. Report Options
       9. Scale and Resize options
          1. Scale tree to fit:
          2. Resize Page to Fit Tree size
          3. inter-box Y scale factor
          4. box shadow scale factor
          5. Know what you want to print on

             ---

    5. Graphs
       1. Common Options
          1. Graphviz Layout
          2. Graphviz Options
          3. Note
       2. Family Lines Graph
          1. Report Options
          2. Report Options (2)
          3. People of Interest
          4. Include
          5. Family Colours
          6. Individuals
       3. Hourglass Graph
          1. Report Options
          2. Report Options (2)
          3. Graph Style
       4. Relationship Graph
          1. Report Options
          2. Report Options (2)
          3. Include
          4. Graph Style
          5. Example

             ---

    6. Text Reports
       1. Common options
          1. Paper Options
          2. Document Options
       2. Ahnentafel Report
          1. Report Options
       3. Birthday and Anniversary Report
          1. Report Options
          2. Text Options
       4. Complete Individual Report
          1. Report Options
          2. Include
          3. Sections
       5. Database Summary Report
          1. Report Options
       6. Descendant Report
          1. Report Options
       7. Detailed Ancestral Report
          1. Report Options
          2. Content
          3. Include
          4. Missing information
       8. Detailed Descendant Report
          1. Report Options
          2. Content
          3. Include
          4. Missing information
       9. End of Line Report
          1. Report Options
       10. Family Group Report
           1. Report Options
           2. Include
           3. Missing information
       11. Kinship Report
           1. Report Options
       12. Note Link Report
       13. Number of Ancestors Report
           1. Report Options
       14. Place Report
           1. Report Options
       15. Records Report
           1. Report Options
           2. Person Records
           3. Family Records
       16. Tag Report
           1. Report Options

              ---

    7. Web Pages
       1. Narrated Web Site
          1. Dialog tabs
             1. Report Options
             2. HTML Options
             3. Display
             4. Page Generation
             5. Extra Pages
             6. Images Generation
             7. Download
             8. Advanced Options
             9. Include
             10. Place Map Options
             11. Other inclusion (CMS, web calendar, PHP)
             12. Translations
             13. Calendar Options
          2. Example Web Site output
             1. Home
             2. Introduction
             3. Individuals
             4. Surnames
             5. Families
             6. Events
             7. Places
             8. Sources
             9. Repositories
             10. Media
             11. Thumbnails
             12. Download
             13. Address Book
             14. Contact
          3. Prerequisites for Narrated Web Site
             1. Possible problems
       2. Web Calendar
          1. Dialog tabs
             1. Report Options
             2. Report Options (2)
             3. Content Options
             4. Advanced Options
             5. Jan - Jun Notes
             6. Jul - Dec Notes
          2. Example Web Site output

             ---

    8. Quick Views
       1. All Events
       2. All Family Events
       3. On This Day
       4. Father lineage
       5. Mother lineage
       6. Siblings
       7. Relation to Home Person
       8. Same Given Names
       9. Same Surnames
       10. Person References
       11. Family References
       12. Event References
       13. Place References
       14. Source References
       15. Citation References
       16. Repository References
       17. Media References
       18. Link References
       19. Note References
    9. Quick View Gramplet
    10. Making your own Quick view

        ---

14. Tools
    1. Tool Selection dialog
    2. Analysis and Exploration
       1. Compare Individual Events
    3. Family Tree Processing
       1. Database Owner Information
       2. Extract Event Description
       3. Extract Information from Names
       4. Extract Place Data from a Place Title
       5. Find Possible Duplicate People
          1. Potential Merges
       6. Fix Capitalization of Family Names
       7. Merge citations
       8. Rename Event Types
       9. Reorder Gramps ID
       10. Sort Events
    4. Family Tree Repair
       1. Check and Repair Database
          1. Gramps had a problem the last time it was run - dialog
       2. Rebuild Gender Statistics
       3. Rebuild Reference Maps
       4. Rebuild Secondary Indices
       5. Remove Unused Objects
    5. Utilities
       1. Media Manager
          1. Replace substrings in the path
          2. Convert paths from relative to absolute
          3. Convert paths from absolute to relative
          4. Add images not included in database
       2. Not Related
       3. Relationship Calculator
       4. Verify the Data
          1. Verify the Data tab pages
             1. General
             2. Women
             3. Men
             4. Families
          2. Data Verification Results window
          3. Examples
       5. Find database loop
    6. Debug
       1. Check Localized Date Displayer and Parser
       2. Dump Gender Statistics
       3. Generate Testcases for Persons and Families
       4. Populate Sources and Citations

          ---

15. Settings
    1. Preferences
       1. Data
          1. Display
             1. Display Name Editor
             2. Place Format Editor
          2. Input Options
       2. General
          1. Environment Settings
             1. Enable spell checker
          2. Tip of the Day dialog
       3. Family Tree
          1. Database Settings
          2. Database Location
          3. Backup Management
          4. Family Tree's Media path
             1. Select media directory dialog
             2. Missing Media Objects 'broken link' icon of a box with a red 'x'
       4. Import
          1. Tag Records
          2. Source GEDCOM import
       5. Limits
          1. Calculation limits
       6. Colors
          1. Colors used for boxes in the graphical views
          2. Colors for Male persons
          3. Colors for Female persons
          4. Colors for people who are neither male nor female
          5. Colors for Unknown persons
          6. Colors for Family nodes
          7. Other colors
       7. Genealogical Symbols
          1. Prerequisite to use Genealogical Symbols
             1. Initial setup
             2. Prerequisite
       8. ID Formats
       9. Text
       10. Warnings
       11. Researcher
    2. Other settings
       1. Column Editor
       2. Sorting columns
       3. Setting Home person
       4. Adjusting viewing controls
       5. Export View
          1. Export View as Spreadsheet dialog
       6. Modularity and plugins
       7. Customize report output formats
          1. Document Styles dialog
          2. Style editor dialog
             1. Style editor dialog tabs
                1. Description
                2. Font options
                3. Paragraph options
       8. Context menu
    3. Customizing
       1. Preferences
       2. Pick a Color selector
          1. Color Palette
          2. Color Gradient
       3. File Chooser
          1. Context Menu options
          2. Breadcrumbs and text-entry address bar
          3. Bookmarking file folders
          4. File Formats
          5. See also
       4. Language
          1. Linux
          2. macOS
          3. MS Windows
       5. Add Windows OS Menu Item
       6. Change the windows LANG variables
       7. Language codes
       8. Advanced manipulation of settings
          1. Example gramps.ini file
          2. Advanced backup filename setting
       9. Theme

          ---

16. Filters
    1. Filter vs. Search
    2. Regular Expressions
       1. Groups and Sets
       2. Examples
          1. Common variations of a surname
          2. testing regular expressions
    3. Custom Filters
    4. Which filters in which Category?
    5. Ancestral filters
    6. Child filters
    7. Citation/sources filters
       1. Persons-, and Relationship Category
       2. Families Category
       3. Events Category
       4. Places Category
       5. Media Category
    8. Descendant filters
    9. Event filters
       1. Persons-, and Relationship Category
       2. Families Category
    10. Family filters
    11. Father filters
    12. General filters
        1. Persons-, and Relationship Category
        2. Families Category
        3. Events Category
        4. Places Category
        5. Sources Category
        6. Citations Category
        7. Repositories Category
        8. Media Category
        9. Notes Category
    13. Mother filters
    14. Position filters
    15. Source filters
    16. Relationship filters
    17. Tagging
        1. Concept
        2. Differences with markers
        3. Tags and Filters
        4. Operations with tags
           1. Filtering
           2. Tagging a selection of objects
        5. Tags Column

---

Appendix A: Frequently Asked Questions

General

What is Gramps?

Where do I get it and how much does it cost?

Do I need to register as a user to use Gramps, I am not a programmer?

Does Gramps exist in other languages?

How do I keep backups?

Does Gramps support Unicode fonts?

Installation

What is needed to install Gramps under Linux, Solaris, or FreeBSD?

Does Gramps work on Windows?

Does Gramps work on the Mac?

Does Gramps work on my mobile device?

Does Gramps work on my Google Chromebook?

What are the Minimum Specs to run Gramps?

How do I upgrade Gramps?

Preferences

Can I change the dates in reports to 'day month year'?

Collaboration-Portability

Is Gramps compatible with other genealogical software?

Can Gramps read files created by other genealogy programs?

Can Gramps write files readable by other genealogy programs?

What standards does Gramps support?

How do I import data from another genealogy program into Gramps?

Can I install Gramps on a Linux Web Server and use it via a web browser?

Reports

Can Gramps print a genealogical tree for my family?

In what formats can Gramps output its reports?

How can I change the default language in reports?

Is Gramps compatible with the Internet?

Can I create custom reports/filters/whatever?

Why are non-Latin characters displayed as garbage in PDF/PS reports?

I would like to contribute to Gramps by writing my favorite report. How do I do that?

Database - Gramps file formats

What is the maximum database size (bytes) Gramps can handle?

How many people can Gramps database handle?

My database is really big. Is there a way around loading all the data into memory?

Can I run Gramps from a database on a NFS share?

What does "portable" mean?

Why is the database format (GRDB) not portable?

Does Gramps have an Example Tree?

Bugs and requests

What do I do if I have found a bug?

Requests

Adding to and editing my database

What is the difference between a residence and an address?

How do I change the order of children?

How do I change the order of spouses?

---

Appendix B: Keybindings reference

List Views

Common bindings

All List Views bindings

People View bindings

Editors

Editor Tab bindings

Editor bindings

Handy Shortcuts

Access Key Shortcuts

See also

---

Appendix C: Command line reference

Start Gramps through the Command Line

Linux

MS Windows

macOS

Python options

Available options

Format options

Opening options

Import options

Export options

Action options

report action option

tool action option

book action option

Force unlock option

Configuration (config) option

Safe mode

Defaults

Operation

Examples

Environment variables

GRAMPSHOME

LANG, LANGUAGE, LC_MESSAGES, LC_TIME

GRAMPSI18N

GRAMPSDIR

GRAMPS_RESOURCES

---

Appendix D: User Directory

POSIX - style systems

macOS

macOS Application Package

MS Windows

---

Appendix E: Error and Warning Reference

When something goes wrong

Alerts

Are you sure you want to upgrade this Family Tree?

Cannot open database

Low level database corruption detected

Error detected in database

Warnings

Gramps Warnings dialog

Locale warnings

Module not loaded warnings

Show plugin status dialog on plugin load error.

Configuration warnings

Other warnings

Cannot save person

Cannot merge <object>

Duplicate Family warning dialog

Suppress warning when adding parents to a child

Suppress warning when cancelling with changed data

Save Changes? dialog

Suppress warning about missing researcher when exporting to GEDCOM

Undo history warning

No selected book item

Person <____> is not in the Database

Autobackup...

Errors

Error Report

Error Reporting Assistant dialog

Report a bug page

Error Details page

System Information page

Further Information page

Bug Report Summary page

Send Bug Report page

Complete page

Seeing all the error messages

Linux

MS Windows

macOS

Console application

---

Appendix F: Further References

User References

Programmers References

Translators References

---

Appendix G: About Gramps

About

Original author

Contributors

Have an issue or idea?

License

---

Special copyright notice: All edits to this page need to be under two different copyright licenses: GNU Free Documentation License 1.2 - see wiki copyright GPL - see manual copyright 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. Also, only use the known Typographical conventions