Guide

Troubleshooting

Answers to the most common problems, and what to try first. If yours isn’t here, we’re glad to help.

The tree says it needs a starting ancestor

The tree is drawn from one person. Go to Ancestral Ledger › Settings › Starting ancestor and choose your earliest known ancestor, or click Start the family tree from this person on their edit screen.

I see the shortcode text instead of the tree

The place you added it doesn’t run shortcodes. In the block editor, use the Family Tree block instead. In Elementor, use the Shortcode widget. The shortcode should look exactly like this, with straight quotation marks:

[ancestral_ledger height="80vh"]

Someone is missing from the tree

They’re not connected. Only people linked to the starting ancestor through parents, children and marriages appear. The People screen tells you when anyone isn’t connected (“N people aren’t connected to the family tree”), and their edit screen shows a warning. Link them to a parent or spouse in the Relationships panel.

Their branch is folded. A folded branch shows a button such as + 12 descendants under the person at its top; click it to open the branch. Or a focused view is on: click Show the whole family.

Dates, places or photos are missing for visitors

That’s Ancestral Ledger’s privacy at work. By default, visitors who aren’t logged in see names only, and living people’s places and photos are hidden. Log in to see everything, or change what visitors see under Ancestral Ledger › Settings.

Person or story pages say “Page not found”

WordPress sometimes needs to refresh its list of page addresses after a plugin is installed or updated. Go to Settings › Permalinks and click Save Changes without changing anything. That’s usually all it takes.

My changes don’t show up on the site

A caching plugin, or your web host’s cache, may be showing an older copy of the page. Clear the cache in your caching plugin or hosting control panel, then reload. If you use Elementor, Elementor › Tools › Clear Files & Data can help too.

My import file is too large, or the import stops

The Import & Export page shows the largest file your site accepts. For a bigger file, ask your web host to raise the upload limit, or export from your genealogy program without photos and add photos afterwards. If a very large import stops partway, your host can also raise the time limit for PHP scripts.

People were added twice after re-importing

Ancestral Ledger recognizes people by their permanent ID, which most genealogy programs save in GEDCOM files. If your file has no IDs, Ancestral Ledger matches people by name and birth year instead, and lists those matches in the check step for you to review.

Always read Who is already on this site before clicking Import: if everyone shows as new, stop and check that you exported the same tree. To clean up duplicates, delete the extra people, or download a backup, use Start over and import again.

Photos are missing after importing

Some programs, including Ancestry, leave photos out of GEDCOM files. Add portraits and photos on your site afterwards; re-importing won’t remove them. Pictures placed inside biographies still point to the site they came from, so upload copies to your Media Library to keep them.

A very large tree feels slow

Large families open with distant branches folded, so the tree loads quickly; open only the branches you want to explore. On an older phone or tablet, Show nearby family keeps the view small and fast.

Still stuck?

Ask on the Support page, and include your WordPress, PHP and Ancestral Ledger versions (Tools › Site Health › Info), your theme, and what you expected to happen. A screenshot helps a lot.