Description
GeneaCanvas GEDCOM Family Tree turns a GEDCOM file into an interactive family tree on your WordPress site. Build a family history website, share your genealogy research with relatives, or add a pedigree chart to any page, without retyping a single name.
Export a .ged file from your genealogy software, upload it to the Media Library, and paste one shortcode. Visitors can then explore your family tree on desktop, tablet and phone: zoom, drag, search for a person, and open a profile with dates, places and close relatives.
There is no limit on the number of people or family trees.
View the interactive demo | Learn about GeneaCanvas PRO
Family tree features in the free plugin
- Forest of Clans: Start with an overview of every family line, then open the clan you want to explore.
- All People view: See the whole family tree at once, with or without repeated people who connect several branches.
- Pedigree chart: Pick any person and show a direct line of their ancestors, without collateral lines.
- Natural tree layout: An organic tree shape that keeps person cards from overlapping.
- Dots for large trees: Show people as small dots to keep very large family trees fast and readable.
- Search: Find a person by name and jump straight to their place in the tree.
- Person profiles: Click a person to see birth and death dates, places, spouses, children and other relatives, and move from one relative to the next.
- Line highlighting: Point at a person to highlight their family line.
- Zoom controls: Use the on-screen + and − buttons, the mouse, or touch gestures.
- Shortcode generator: Choose the starting view, layout, theme, expanded generations, height and titles, then copy a ready-made shortcode.
- Works with your theme: Use the shortcode in the block editor, the classic editor, or any page builder that supports shortcodes.
- Translations included: English, Polish, German, French, Spanish and Italian.
GeneaCanvas PRO for family history projects
Everything above stays free. GeneaCanvas PRO is a separate add-on for sites that need privacy, printing and richer family stories:
- Privacy for living relatives: Dates, places and photos of living people are removed on the server and only appear after a family password is entered. You can also hide their first names.
- Password for each shortcode: Protect the whole tree or only living people, separately on each page.
- Hourglass view: Show the ancestors and descendants of a chosen person or marriage at the same time, and open it directly from a shortcode.
- Kinship calculator: Name the relationship between any two people and draw the line that connects them.
- Print-ready PDF and SVG: Export a sharp vector PDF for any paper size, or an image PDF up to 600 DPI, with portrait photos.
- Portrait photos: Add photos to people, with frames, shapes and sepia or black and white styles.
- Theme editor: Change colors, fonts and card styles of seven ready-made themes, or create your own.
- Full GEDCOM data: Show occupations, life events, biographical notes and sources in the person profile.
- Document gallery: Attach scans of certificates and other documents to a person.
- Family statistics: Most common names and places, lifespans, generations and births by century, in the tree or with a shortcode.
- Family anniversaries: Show upcoming birthdays and wedding anniversaries in a widget or shortcode, with optional email reminders.
- Suggestions from relatives: Let family members send corrections, photos, occupations, notes and events for you to approve.
- Clan filters: Show or hide clans by surname, ID or number of members for each shortcode.
- Block and Elementor widget: Place a tree and set its options without writing a shortcode.
- Priority support and automatic updates.
Works with popular genealogy software
GeneaCanvas reads standard GEDCOM 5.5 and 5.5.1 files, including exports from:
- Gramps
- RootsMagic
- Family Tree Maker
- MyHeritage
- Ancestry
- Legacy Family Tree
- Ahnenblatt
Third-Party Libraries
This plugin includes D3.js 7.8.5 (ISC License) in minified form as js/d3.min.js. The source code is available at github.com/d3/d3.
Installation
- In your WordPress admin go to Plugins > Add New, search for GeneaCanvas, then install and activate the plugin.
- Go to Trees (Canvas) > Add New Tree and give your family tree a name.
- Upload your
.gedor.txtGEDCOM file and publish the tree. - Set the options in the Shortcode Generator panel and copy the shortcode, for example
[gcgft_tree id="12"]. - Paste the shortcode into any page or post.
FAQ
How do I add a family tree to my WordPress site?
Export a GEDCOM file from your genealogy software, create a new tree under Trees (Canvas), upload the file, and paste the generated shortcode into a page. For example: [gcgft_tree id="123"].
What is a GEDCOM file?
GEDCOM is the standard file format for exchanging family tree data. Nearly all genealogy programs and websites can export it, usually with an option such as “Export GEDCOM”. GeneaCanvas accepts .ged and .txt files.
Is there a limit on people or family trees in the free version?
No. You can import as many people and create as many family trees as your hosting can handle.
Does the family tree work on phones and tablets?
Yes. The tree supports touch gestures, and on smaller screens the tools move to a compact side menu.
Can I build a family tree by hand in WordPress?
No. GeneaCanvas displays data from a GEDCOM file. You edit your family tree in your genealogy software and upload the updated file, so that program stays the single source of your research.
How do I keep the data of living relatives private?
The free plugin shows everything in your GEDCOM file, so remove or anonymize living people before you export it. GeneaCanvas PRO can hide their data on the server behind a family password.
Which shortcode options are available?
With only the id, a tree starts as the Forest of Clans in the natural layout, without dots. The generator adds only the options you change:
view:unified-forest,giga-tree,giga-tree-duplicates, or the GEDCOM ID of a clan founderorganic:yesornodot:yesornotheme:modern-tealorclassic-browngenerations: expanded generations on startup, 1 to 15 (default 4)clans: clans shown on the forest view, 1 to 100 (default 12)height: for example750pxor80vhtitleandsubtitle: header texts
Trees configured before version 1.2.0 keep their saved settings unless the shortcode sets a different value.
Can I display two different family trees on one page?
No. One family tree can be displayed per page. The same tree can be used on any number of pages, each with its own shortcode options.
Can I print my family tree or export it to PDF?
PDF and SVG export is available in GeneaCanvas PRO.
Changelog
1.3
- New: Shortcode generator. Starting view, layout, display mode, theme, generations, clan limit, height and titles are now shortcode options.
- New: On-screen + and − zoom buttons.
- New: The active tree ID is passed to the tree script and to extensions, with new hooks for tree rendering and clan lists.
- Tweak: Shorter, clearer toolbar labels with descriptions on hover.
- Tweak: Removed an unused landing page template, PRO-only styles and data, and debug logging.
- Fix: Corrected many translations in German, French, Spanish, Italian and Polish.
- Fix: Saving a tree no longer clears its cache when the GEDCOM file has not changed.
- Fix: Families listed before individuals in a GEDCOM file no longer lose their relations.
- Fix: A death record without a date now marks the person as deceased.
- Fix: Plugin styles no longer affect the header and elements of the site theme.
- Fix: GEDCOM dates are now translatable.
- Fix: Clan names are escaped in the person profile.
- Fix: Restored the icons shown before notes about multiple marriages and shared ancestors.
- Security: Files with a .ged or .txt extension bypass the file type check only when they start with a GEDCOM header, and unpublished trees are visible only to users who can edit them.
1.2.4
- Enhancement: Redesigned and streamlined top navigation bar controls — removed verbose “(Enabled)/(Disabled)” labels in favor of clean active toggle states (
.is-active) matching theme hover styles. - Enhancement: Expanded responsive off-canvas menu breakpoint from 768px to 1024px to provide a clean, uncluttered layout with hamburger drawer navigation on tablets.
- Enhancement: Fixed off-canvas button active and hover states so active features are distinct and clearly distinguishable on touchscreens.
- Fix: Auto-close details sidebar when clicking ancestor/descendant relationships on tablets (<= 1024px) to ensure unblocked canvas framing.
- Feature: Added GDPR / Privacy notice in wp-admin tree editor when living individuals are detected in uploaded GEDCOM files.
1.2.3
- Fix: Resolved an issue where translations were ignored and the interface defaulted to English. Textdomain loading is now hooked early on init with proper relative path resolution.
1.2.2
- Feature: Added a dedicated mobile off-canvas drawer menu (hamburger toggle) for toolbar controls on mobile devices (max-width: 768px).
- Enhancement: Streamlined mobile viewport layout keeping only the search bar and family header visible for maximal tree canvas space on 100vh screens.
- Fix: Relocated mobile off-canvas container to document body to eliminate clipping caused by overflow:hidden wrappers on various themes.
- Fix: Fixed search navigation and person auto-focus when operating inside the Pedigree (ancestor) mode.
- Fix: Raised search dropdown suggestions z-index to overlay clan title labels on mobile displays.
- Fix: Auto-close individual details sidebar when navigating through blood line or spouse clan links to expose camera transitions.
- Tweak: Replaced non-standard arrow glyphs with universal standard unicode arrows for consistent cross-device rendering.
1.2.1
- Enhancement: Added full plugin translations for German (de_DE), French (fr_FR), Spanish (es_ES), and Italian (it_IT) to support a global user base.
1.2.0
- Feature: Introduced the “Pedigree View” (Ancestors Mode). You can now select any person and generate a clean, direct-line ancestor chart upwards without collateral branches.
- Feature: Added a “Return to full tree” reset button in the UI to seamlessly switch back to the complete canvas view.
- Enhancement: Updated
readme.txttags to strictly comply with WordPress.org repository guidelines (limited to 5 tags). - Enhancement: Prepared core architecture to seamlessly integrate with new GeneaCanvas PRO features (Hourglass View, Interactive Maps, Kinship Calculator).
1.1.4
- Fix: Fixed clan root detection and descendant tree building for multiple marriages — prevented mothers from hijacking husband clans and combining half-siblings under step-parents.
- Enhancement: Added interactive background SVG tree artwork into the D3 canvas layer that zooms, pans, and dynamically adopts the active color theme.
- Enhancement: Implemented dynamic bounding box calculation for the background tree — automatically resizes to fit small clans (1-2 generations) as well as massive Giga-Trees.
- Fix: Bottom-anchored the background tree to ensure root ancestors and founder cards always sit naturally at the trunk and roots.
- Fix: Fixed WordPress
wp_localize_scriptboolean string-casting bug where startup settings for “Dot Mode” and “Organic (Beautiful) Tree” were ignored. - Fix: Resolved startup view bug where selecting “Giga-Tree” or specific clans defaulted back to the Forest view.
- Fix: Added event protection against synthetic browser autofill and theme
changeevents on the clan selector dropdown during page load. - Fix: Improved
resetTreePerspective()camera framing with responsive scaling for mobile/tablet screens and support for Giga-Tree with duplicates.
1.1.3
- Fix: Improved tree canvas rendering logic.
- Tweak: Redesigned header layout into a structured two-row layout (clan title and statistics on top, toolbar controls below).
- Fix: Removed unwanted theme margins between the clan title and subtitle.
- Tweak: Removed bottom border line from the header for a cleaner, modern look.
- Tweak: Improved responsiveness and alignment of the stats block and control buttons.
1.1.2
- Enhancement: Redesigned mobile and tablet UX with an ultra-compact HUD and fixed bottom clan navigation bar.
- Enhancement: Dynamic branch and line stroke highlighting now fully inherits active CSS theme colors.
- Enhancement: Optimized D3.js spacing grid to ensure spouses and siblings never overlap in standard tree mode.
- Enhancement: Integrated extensible JavaScript callback hooks for modular tree layout customizers.
- Enhancement: Standardized all internal file operations using native WP_Filesystem and wp_delete_file APIs.
- Fix: Expanded SVG foreignObject viewport bounds to eliminate rectangular clipping on glow highlight animations.
- Fix: Added automated mobile sidebar drawer closing when navigating through relatives and search results.
- Fix: Adjusted mobile z-index layering so full-width details drawers seamlessly overlay navigation controls.
- Fix: Hardened security with comprehensive input unslashing, sanitization, and output escaping.
- Fix: Unified all internal function prefixes and text domains to match WordPress.org standards.
1.1.1
- Enhanced translation loading and text domain handling.
- Expanded and improved documentation.
- Performance optimizations for large GEDCOM datasets.
1.1.0
- Initial public release on WordPress.org.
