Guide

Customizing the look

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.

Changing the tree’s colors and fonts

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.

Where to add CSS

Block themes: Appearance › Editor › Styles, then Additional CSS from the Styles menu.

Classic themes: Appearance › Customize › Additional CSS.

Elementor Pro: Site Settings › Custom CSS.

Reference: the tree’s style settings

--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.

Going further

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.

The tree’s size

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

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.