=== General Usage and Configuration ===

The container controls for Gramplets are arranged a little differently in the Dashboard category View as opposed to the Sidebar and Bottombar. Being aware of how these Gramplet containers differ (and are similar) will let you focus on getting the high speed performance instead of wondering why it spun out of control.

The split pane approach reduces the need for flipping between Category Views... and that lightens the demands on the database.

<!-- This is in the WRONG place! We're still talking about how the containers for Gramplets work... not yet to using the Gramplet's themselves.

[[File:Menubar-View-overview-example-60.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} View menu]]

You can also change the number of columns by changing a ''Gramplets Layout'' tab setting in ''Configure Dashboard'' window. To open the window, click the [[File:Gramps-config.png]]{{man button|Configure...}}&nbsp;button, choose {{Man menu|View&nbsp;&#x27a1;&nbsp;Configure...}} from the View menu, or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Each Gramplet docked in the Dashboard will also have a Configuration tab added. (But the same Gramplet may not have any Configuration options or tab when docked in the Sidebar or Bottombar.) The Dashboard provides extra options for each Gramplet to allow it be renamed, set to a fixed vertical size, or be maximized vertically in its column. The Configuration tab for Gramplets in docked in the Dashboard reflect at least these minimum options.

== Summary of Gramplets ==

Independently for each Category view mode container, the Gramplets can be added or removed using the following controls:

{{-}}

===Gramplet List===

{| class="wikitable sortable"

|-

{{-}}

{{stub}}<!-- test and rename section -->

=== Ancestors ===

Use the {{man label|Ancestors}} Gramplet to show ancestors of the active person. It is intended to be used as a navigation help, an alternative way to move through your family tree in Gramps . If you detach the Gramplet, and place it next to Gramps, it will allow you to use it to easily change the content of the current "Person view".

{{-}}

The Attributes Gramplet shows all of the attributes for the current, active person. Double click on the name of the attribute, and you will run a Quick View that shows all of the people that have that attribute, and the values for it. You can sort the Quick View by the attribute value by clicking on the column name.

{{-}}

{{stub}}<!-- test and rename section -->

[[File:Atttribute-Gramplet-QuickView-example-result-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attributes Gramplet - Quick View example result]]

=== Children ===

[[Gramps_6.0_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_children.3F|How do I change the order of children?]]

{{-}}

====Person Children====

See [[Gramps_6.0_Wiki_Manual_-_Gramplets#Children|Children]]

{{-}}

=== Details ===

Provides a brief non editable summary of the selected person for example:

* ''Image'': If available the primary image will be shown to the right of the details, otherwise a cross will indicate the image is missing, you may double click the image to open it in an external viewer. To change the primary active image see: [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Edit Person Editors - Gallery tab]]

You may highlight and copy the individual text fields.

The {{man label|FAQ Gramplet}} (Frequently Asked Questions) shows a list of common questions, and links to their answers from the Gramps Wiki (requires an internet connection).

The idea is to make the answers to the most common question easier to find, the primary objective is to let new users start using Gramps more quickly.

====See Also====

* Bug Report {{bug|11997}}: how to add/update FAQs

{{-}}

======General usage ======

{{stub}}<!-- add section or redirect on general usage of these filter gramplets -->

*[[Gramps_6.0_Wiki_Manual_-_Filters#Which_filters_in_which_Category.3F|Which filters (rules) in which Category?]]

*Gramps Glossary term: [[Gramps_Glossary#regex|Regular Expressions]] for pattern matching in searches

{{-}}

<span id="Person Filter"></span>

====People Filter====

[[File:FilterGramplet-Person-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People - "Filter Gramplet" - detached - default]]

*{{man label|Name}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_the_.3Cname.3E|People with a name matching &lt;text>]]

*{{man label|ID}} : [[Gramps_6.0_Wiki_Manual_-_Filters#People_with_.3Cid.3E|People with Id containing &lt;text>]]

{{-}}

<span id="Family Filter"></span>

====Families Filter====

[[File:FilterGramplet-Family-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families - "Filter Gramplet" - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Families_having_child_with_id_containing_.3Ctext.3E|Families with Id containing &lt;text>]]

* Father :[[Gramps_6.0_Wiki_Manual_-_Filters#Families_with_father_with_the_.3Cname.3E|Families with father matching the &lt;regex_name>]]

====Events Filter====

[[File:FilterGramplet-Event-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events - Filter Gramplet - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_with_Id_containing_.3Ctext.3E|Events with Id containing &lt;text>]]

* Description : [[Gramps_6.0_Wiki_Manual_-_Filters#Events_matching_parameters|Events matching parameters]]

====Places Filter====

[[File:FilterGramplet-Place-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places - Filter Gramplet - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_with_Id_containing_.3Ctext.3E|Places with Id containing &lt;text>]]

* Name : [[Gramps_6.0_Wiki_Manual_-_Filters#Places_matching_parameters|Places matching parameters]]

====Sources Filter====

[[File:FilterGramplet-Source-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources - Filter Gramplet - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_with_Id_containing_.3Ctext.3E|Sources with Id containing &lt;text>]]

* Title : [[Gramps_6.0_Wiki_Manual_-_Filters#Sources_matching_parameters|Sources matching parameters]]<!--[[Gramps_6.0_Wiki_Manual_-_Filters#Sources_with_title_containing_.3Ctext.3E|Sources with title containing &lt;text>]]-->

====Citations Filter====

[[File:FilterGramplet-Citation-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citations - Filter Gramplet - detached - default]]

'''Source:'''

====Repositories Filter====

[[File:FilterGramplet-Repository-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repositories - "Filter Gramplet" - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_with_Id_containing_.3Ctext.3E|Repositories with Id containing &lt;text>]]

* Name : [[Gramps_6.0_Wiki_Manual_-_Filters#Repositories_matching_parameters|Repositories matching parameters]]

====Media Filter====

[[File:FilterGramplet-Media-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media - Filter Gramplet - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_with_Id_containing_.3Ctext.3E|Media objects with Id containing &lt;text>]]

* Title : [[Gramps_6.0_Wiki_Manual_-_Filters#Media_objects_matching_parameters|Media objects matching parameters]]

====Notes Filter====

[[File:FilterGramplet-Notes-detached-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes - Filter Gramplet - detached - default]]

* ID : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_with_Id_containing_.3Ctext.3E|Notes with Id containing &lt;text>]]

* Text : [[Gramps_6.0_Wiki_Manual_-_Filters#Notes_matching_parameters|Notes matching parameters]]

=== Gallery ===

Gramplet showing media objects. The first image is the primary active media object that is used in reports and the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person dialog]]}}.

=== Given Name Cloud ===

The {{man label|Given Name Cloud}} Gramplet shows the top most popular given names in your family tree. The font size of the name indicates how popular it is. Mouse over the name to see the exact count, and the percent of people in the family tree that have that name.

Double-click on the given name to bring up a Quick View of all of the matching people.

* [[#Surname_Cloud|Surname Cloud Gramplet]]

{{stub}}<!-- test and rename section -->

=== Image Metadata ===

The {{man label|Image Metadata}} Gramplet offers an interface to look at [https://en.wikipedia.org/wiki/Exchangeable_image_file_format Image Exif Metadata] from your images (*.jpg, *.png. *.tiff, *.exv, *.nef, *.psd, *.pgf).

{{-}}

* [[Addon:Edit Image Exif Metadata]]

=== Pedigree ===

Using the content of the Pedigree in another program requires a bit of effort Open a contextual pop-up menu by right-clicking anywhere in the gramplet except a hotlink. Or, you can begin a drag selection from the same inert areas. Copy the highlighted text the OS clipboard from that same context menu. (The keybinding for 'Copy' will not work.) When you paste the text into another text editing program, you may need change the font to a non-proportional font to preserve the indentation. Some online services collapse leading spaces when you post a chunk of text. Preserving the indentation for such services may require replacing doubled spaces with doubled placeholder characters... like periods/full stops.

====&#x2699; Configurable Options====

=== Python Evaluation ===

{{man warn|Warning! Diagnostic Tool|Do not use this '''[[Gramps_6.0_Wiki_Manual_-_Tools#Debug|Debug]]''' feature on your working Family Tree. Always create a new empty Family Tree or a copy of your existing Family Tree for testing.<br />This option is only available when Gramps has been started using a developer [[Gramps_6.0_Wiki_Manual_-_Command_Line#Python_options|mode switch]]. It is not intended for general use and has limited safeguards.}}

[[File:QuickView-Gramplet-detached-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Quick View Gramplet - detached example]]

You can run any of the builtin [[Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]] or [[6.0_Addons#Addon_List|addon]] QuickView reports.

You may copy the text from inside of this Gramplet by selecting it and pasting into an empty document.

{{-}}

[[File:WhatsNext-Gramplet-Configuration-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} What's Next? Gramplet - Configuration tab shown]]