# Need to add the References tab to Family window

**URL:** <https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135>\
**Category:** Ideas\
**Tags:** roadmap-item\
**Created:** [March 1, 2025, 2:38pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135 "2025-03-01T14:38:20Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![PLegoux](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/plegoux/32/413_2.png) [@PLegoux](https://gramps.discourse.group/u/PLegoux)\
**Post date:** [March 1, 2025, 2:38pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/1 "2025-03-01T14:38:20Z")

</div>

In a next version, could a References tab be added to Family editor window (like on any other window)? We could see all references (notes, etc.) to the family.

 ![image](https://global.discourse-cdn.com/free1/uploads/gramps/original/2X/5/54e3bd46c7e4aa4e290b5c08f7bf09e394e64be1.png)

Mantis entry created: [0013673: Add a References tab to Family editor dialog - Gramps - Bugtracker – Free Genealogy Software](https://gramps-project.org/bugs/view.php?id=13673)

---

<div class="post-metadata">

**Author:** ![chtiland](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/chtiland/32/878_2.png) [@chtiland](https://gramps.discourse.group/u/chtiland)\
**Post date:** [March 2, 2025, 5:42pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/2 "2025-03-02T17:42:51Z")

</div>

I didn’t even that this one was not in this view, on the other hand I add “References” gramplet on each list I find it more useful. May be this should help you too until they implement this feature ?

---

<div class="post-metadata">

**Author:** ![SteveY](https://avatars.discourse-cdn.com/v4/letter/s/85e7bf/32.png) [@SteveY](https://gramps.discourse.group/u/SteveY)\
**Post date:** [March 2, 2025, 10:10pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/3 "2025-03-02T22:10:57Z")

</div>

> [@PLegoux](#):
>
> In a next version, could a References tab be added to Family editor window (like on any other window)? We could see all references (notes, etc.) to the family.

@PLegoux Is this what you wanted?  
The image shows a new “References” tab in the edit family dialog.  
In the background is the References gramplet for the same family. This already exists.  
This is the example gramps database.

 ![image](https://global.discourse-cdn.com/free1/uploads/gramps/original/2X/a/a98b14442bd12586cb87680af903421815b31a86.png)

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [March 2, 2025, 10:30pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/4 "2025-03-02T22:30:51Z")

</div>

Family view’s References gramplet is limited to Person secondary objects.

It seems like @PLegoux is asking for the full complement of direct secondary object backlink references in the same way that the Person Object Editor has. The Family object backlink references: spouse/children People, Events, and Notes objects.

Citations/Sources, Attributes, Addresses, Media, Internet and LDS seem to be ignored in the Person Object Editor references. There are no Family-to-Family or Association-Family references, right?

### References

GUI [https://gramps-project.org/wiki/index.php/References#Using\_the\_References\_tab](https://gramps-project.org/wiki/index.php/References#Using_the_References_tab)  
API [https://gramps-project.org/wiki/index.php/Using\_database\_API#Finding\_references](https://gramps-project.org/wiki/index.php/Using_database_API#Finding_references)

---

<div class="post-metadata">

**Author:** ![SteveY](https://avatars.discourse-cdn.com/v4/letter/s/85e7bf/32.png) [@SteveY](https://gramps.discourse.group/u/SteveY)\
**Post date:** [March 2, 2025, 11:19pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/5 "2025-03-02T23:19:38Z")

</div>

> [@emyoulation](#):
>
> It seems like @PLegoux is asking for the full complement of direct secondary object backlink references

Whilst my example screenshot only shows people, it will show backlinks of all types. Internally, it uses the existing code.

> [@emyoulation](#):
>
> There are no Family-to-Family or Association-Family references, right?

I don’t think so

---

<div class="post-metadata">

**Author:** ![PLegoux](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/plegoux/32/413_2.png) [@PLegoux](https://gramps.discourse.group/u/PLegoux)\
**Post date:** [March 3, 2025, 9:54am UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/6 "2025-03-03T09:54:54Z")

</div>

> [@SteveY](#):
>
> @PLegoux Is this what you wanted?  
> The image shows a new “References” tab in the edit family dialog.

> [@emyoulation](#):
>
> It seems like @PLegoux is asking for the full complement of direct secondary object backlink references **in the same way that the Person Object Editor has**. The Family object backlink references: spouse/children People, Events, and Notes objects.

Yes, that’s exactly it.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [March 6, 2025, 4:58pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/7 "2025-03-06T16:58:03Z")

</div>

> [@PLegoux](#):
>
> > [@emyoulation](#):
> >
> > It seems like @PLegoux is asking for the full complement of direct secondary object backlink references **in the same way that the Person Object Editor has**. The Family object backlink references: spouse/children People, Events, and Notes objects.
> 
> Yes, that’s exactly it.

I looked into what the References tabs are showing. They are the `backlinks`, not the list of secondary objects.

```python
[Gramps SuperTool script file]
version=1

[title]
People Backlinks (see Print output tab)

[description]
find the `backlinks` shown in References tab in People object editor. `find_backlink_handles(handle)`

https://github.com/gramps-project/gramps/blob/maintenance/gramps52/gramps/plugins/gramplet/backlinks.py5

https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/5

[category]
People

[statements]
handle = obj.handle
backlinks = db.find_backlink_handles(handle)

print(f"Backlinks for {category} ({handle}): {gramps_id}")
for class_name, bhandle in backlinks:
    obj_id = None
    if class_name == 'Person':
        obj_id = db.get_person_from_handle(bhandle).gramps_id
    elif class_name == 'Family':
        obj_id = db.get_family_from_handle(bhandle).gramps_id
    elif class_name == 'Event':
        obj_id = db.get_event_from_handle(bhandle).gramps_id
    elif class_name == 'Place':
        obj_id = db.get_place_from_handle(bhandle).gramps_id
    elif class_name == 'Source':
        obj_id = db.get_source_from_handle(bhandle).gramps_id
    elif class_name == 'Citation':
        obj_id = db.get_citation_from_handle(bhandle).gramps_id
    elif class_name == 'Repository':
        obj_id = db.get_repository_from_handle(bhandle).gramps_id
    elif class_name == 'Media':
        obj_id = db.get_media_from_handle(bhandle).gramps_id
    elif class_name == 'Note':
        obj_id = db.get_note_from_handle(bhandle).gramps_id
    print(f"- {class_name}: {bhandle} (ID: {obj_id})")

[scope]
selected

```

returns (for Home Person of example.gramps)

```python
Backlinks for People (GNUJQCL9MD64AM56OH): I0044
- Person: Q8HKQC3VMRM1M6M7ES (ID: I1200)
- Family: 9OUJQCBOHW9UEK9CNV (ID: F0017)
- Person: VJFKQCFO7WESWPNKHE (ID: I1106)
- Note: ac380498bac48eedee8 (ID: N0001)
- Note: d0436be64ac277b615b79b34e72 (ID: _custom1)
- Note: f68ce7c9cc166a6424e4fe11a1f (ID: N0024)
- Family: 8OUJQCUVZ0XML7BQLF (ID: F0018)

```

### Every reference instead of (or optionally) just backlinks

@PLegoux Do you want to request an enhancement for all the References tabs? (6.0 [PR#1832](https://github.com/gramps-project/gramps/pull/1832) will give a bit more functionality to the tab with a context menu.)

```python
[Gramps SuperTool script file]
version=1

[title]
People Secondary Objects (see Print output tab)

[description]
find the "Secondary objects", augments the References tab in People object editor. (`get_referenced_handles_recursively`)

https://github.com/gramps-project/gramps/blob/maintenance/gramps52/gramps/plugins/gramplet/backlinks.py5

https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/5

[category]
People

[statements]
handle = obj.handle
secondarylinks = obj.get_referenced_handles_recursively()

print(f"Secondary links for {category} ({handle}): {gramps_id}")
for class_name, bhandle in secondarylinks:
    obj_id = None
    if class_name == 'Person':
        obj_id = db.get_person_from_handle(bhandle).gramps_id
    elif class_name == 'Family':
        obj_id = db.get_family_from_handle(bhandle).gramps_id
    elif class_name == 'Event':
        obj_id = db.get_event_from_handle(bhandle).gramps_id
    elif class_name == 'Place':
        obj_id = db.get_place_from_handle(bhandle).gramps_id
    elif class_name == 'Source':
        obj_id = db.get_source_from_handle(bhandle).gramps_id
    elif class_name == 'Citation':
        obj_id = db.get_citation_from_handle(bhandle).gramps_id
    elif class_name == 'Repository':
        obj_id = db.get_repository_from_handle(bhandle).gramps_id
    elif class_name == 'Media':
        obj_id = db.get_media_from_handle(bhandle).gramps_id
    elif class_name == 'Note':
        obj_id = db.get_note_from_handle(bhandle).gramps_id
    print(f"- {class_name}: {bhandle} (ID: {obj_id})")

[scope]
selected

```

returns (for Home Person of example.gramps)

```python
Secondary links for People (GNUJQCL9MD64AM56OH): I0044
- Family: 9OUJQCBOHW9UEK9CNV (ID: F0017)
- Family: 8OUJQCUVZ0XML7BQLF (ID: F0018)
- Note: ac380498c020c7bcdc7 (ID: N0003)
- Note: b39ff01f75c1f76859a (ID: N0013)
- Note: b39ff11d8912173cded (ID: N0014)
- Note: c140d4c29520c92055c (ID: N0015)
- Citation: c140d5e5dbf300411bf (ID: C2831)
- Citation: c140d25efc045ab2ea5 (ID: C0974)
- Citation: c140d25efe703834da4 (ID: C0975)
- Citation: c140d53ab8b377b4174 (ID: C2828)
- Citation: fb471c4e917139fd7ee300b9b28 (ID: C02863)
- Tag: bb80c2b235b0a1b3f49 (ID: None)
- Citation: c140d56d19a1ced4c7a (ID: C2829)
- Media: B1AUFQV7H8R9NR4SZM (ID: O0008)
- Media: 238CGQ939HG18SS5MG (ID: O0010)
- Note: ac380498bac48eedee8 (ID: N0001)
- Citation: c140d25ef1c0e90ee81 (ID: C0973)
- Citation: c140d5aa362797c32d4 (ID: C2830)
- Citation: c140d5e5dbf300411bf (ID: C2831)
- Citation: c140d73a2ca52f37800 (ID: C2835)
- Place: WTAKQCGG8L8LYZCSBB (ID: P1643)
- Family: 8OUJQCUVZ0XML7BQLF (ID: F0018)
- Note: ac3804a8405171ef666 (ID: N0006)
- Citation: c140d694e647717b683 (ID: C2832)
- Citation: f7074a2495c517d87df60cd47ab (ID: C2857)
- Person: VJFKQCFO7WESWPNKHE (ID: I1106)
- Person: Q8HKQC3VMRM1M6M7ES (ID: I1200)
- Citation: c140d694e647717b683 (ID: C2832)
- Person: VJFKQCFO7WESWPNKHE (ID: I1106)
- Event: a5af0ecb107303354a0 (ID: E1656)
- Citation: c140d7c7bdc1fedb030 (ID: C2836)
- Event: a5af0ecb11f5ac3110e (ID: E1657)
- Event: a5af0ecb12e29af8a5d (ID: E1658)

```

---

<div class="post-metadata">

**Author:** ![PLegoux](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/plegoux/32/413_2.png) [@PLegoux](https://gramps.discourse.group/u/PLegoux)\
**Post date:** [March 6, 2025, 5:04pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/8 "2025-03-06T17:04:32Z")

</div>

More is probably better but at least the same as what is currently found in the Person references

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [March 6, 2025, 5:32pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/9 "2025-03-06T17:32:35Z")

</div>

filed Feature request:

- [0013682](https://gramps-project.org/bugs/view.php?id=13682): References tabs of Object Editors: add option to list secondary objects to augment current Backlinks list

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [April 27, 2025, 12:55pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/12 "2025-04-27T12:55:59Z")

</div>

See  
[Pull Request 2005](https://github.com/gramps-project/gramps/pull/2005) Add a “References” tab to the edit family dialog

On the 6.1 Roadmap

---

<div class="post-metadata">

**Author:** ![PLegoux](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/plegoux/32/413_2.png) [@PLegoux](https://gramps.discourse.group/u/PLegoux)\
**Post date:** [April 27, 2025, 2:58pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/13 "2025-04-27T14:58:20Z")

</div>

Yes I’ve seen that. Thanks to the team 🙏

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [April 27, 2025, 3:10pm UTC](https://gramps.discourse.group/t/need-to-add-the-references-tab-to-family-window/7135/14 "2025-04-27T15:10:27Z")

</div>

Just adding a cross-reference the PR so the Idea can be marked ‘Solved’ when 6.1 is released.