Guide
Ancestral Ledger fits in with your site out of the box. If you’d like the family tree to match your colors and fonts more closely, a few lines of CSS will do it.
The tree’s look is controlled by 12 style settings: CSS custom properties whose names begin with --famline-. You don’t change color, border-color or any other CSS property yourself. Instead, you give a setting a new value inside a .famline-tree { } rule, and Ancestral Ledger applies it everywhere that setting is used: text, backgrounds, borders and the tree’s lines. For example, this makes the accents a deeper green, warms the background and uses Libre Caslon for names:
.famline-tree {
--famline-pine: #1F3D2C;
--famline-paper: #F5F0E4;
--famline-serif: "Libre Caslon Text", Georgia, serif;
}
Write each setting exactly as it appears in the reference below, then a colon, the new value and a semicolon. Only list the settings you want to change; the others keep their defaults. The value must be the right kind: a color for color settings, a shadow for the shadow, and a list of fonts for the two font settings.
Example: to make the lines between parents and children darker, add:
.famline-tree {
--famline-line: #5B6A66;
}
That’s all it takes. Ancestral Ledger uses this setting for the lines’ color (their stroke), and for everything else listed against --famline-line in the reference below, so they all change together.
Tip: keep text dark enough to read against the backgrounds you choose. The defaults meet accessibility contrast guidelines; a free online contrast checker will tell you if your colors do too.
Block themes: Appearance › Editor › Styles, then Additional CSS from the Styles menu.
Classic themes: Appearance › Customize › Additional CSS.
Elementor Pro: Site Settings › Custom CSS.
--famline-paper
Color. The tree’s background, and the small ring around the dots on partner lines. Default #E6ECE8 (pale sage).
--famline-card
Color. Person cards, the side panel, the zoom buttons, the overview map and the legend. Default #FBFCFA (warm white).
--famline-ink
Color. Main text, including first names on the cards. Default #1D2A2A.
--famline-muted
Color. Secondary text: surnames and years on the cards, and labels in the side panel. Default #5B6A66.
--famline-pine
Color. The main accent: the left edge of living people’s cards, the outline of the selected card, highlighted lines in direct-line view, and keyboard focus outlines. Default #2E5E52 (pine green).
--famline-pine-soft
Color. Light highlight behind buttons and search suggestions when you point at them, and behind portraits while they load. Default #D5E3DD.
--famline-brass
Color. Lines and dots between partners, the matching legend, and the outline of a card selected with the keyboard. Default #9A7426 (brass).
--famline-brass-text
Color. Small brass-colored text, such as marriage labels; darker than the brass so it stays readable. Default #7A5A16.
--famline-line
Color. Lines between parents and children, the left edge of cards for people who have died, and thin borders around the side panel and search box. Default #93A59F.
--famline-shadow
Shadow (a CSS box-shadow value). The soft shadow under cards, the zoom buttons, the overview map and the legend. Use none to remove it.
--famline-serif
Font list. People’s names on the cards and in the side panel. Default Georgia, "Times New Roman", serif.
--famline-sans
Font list. All other text in the tree. By default it uses your theme’s font.
The settings cover colors, the shadow and fonts. For anything else, you can target the tree’s parts with ordinary CSS. For example, this makes all the tree’s lines thicker:
.famline-tree .react-flow__edge-path {
stroke-width: 2.5px;
}
These internal names (anything other than .famline-tree and the --famline- settings) may change in a future version, so check your custom CSS after updating Ancestral Ledger.
Set the height in the Family Tree block’s settings, or with the shortcode’s height option, in pixels (600px), a share of the screen height (80vh) or a percentage. See the family tree guide for details.
Person pages and stories use your theme’s fonts, colors and spacing, so they already match the rest of your site. To change their layout, see Designing your own layouts in the Person pages and stories guide.