Docs

CSS Token Reference

3 min readUpdated November 10, 2026

WP LinkCanvas styles every part of the bio page with CSS custom properties (variables) that start with --nlb-. They are set on body.nlb-page and apply to the page, card, links, social icons and player.

The theme sets these values: choosing a preset or using the Custom Theme Builder writes them. You can override any of them with Custom CSS on one bio page or with a stylesheet for all of them.

Page tokens#

The page and the card around your content.

Token What it controls
--nlb-page-bg Full-page background colour or gradient
--nlb-card-bg Card background (built from the two card colours)
--nlb-card-bg-2 Second colour of the card gradient
--nlb-card-bg-fallback Solid colour used where gradients are not supported
--nlb-card-radius Card corner radius
--nlb-card-border-color Card border colour
--nlb-card-border-width Card border thickness
--nlb-card-shadow Shadow under the card
--nlb-card-max Maximum width of the card
--nlb-card-padding-x Horizontal padding inside the card
--nlb-card-padding-y Vertical padding inside the card
--nlb-bg-image Optional background image behind the card
--nlb-text Default text colour
--nlb-text-muted Secondary text colour
--nlb-accent Accent colour for highlights and featured links
--nlb-selection-bg Background of selected text
--nlb-selection-color Colour of selected text
--nlb-font-family Body font
--nlb-heading-font-family Heading font

Profile tokens#

The profile photo, display name, subtitle and bio.

Token What it controls
--nlb-avatar-size Profile photo diameter
--nlb-avatar-ring-color Ring colour around the photo
--nlb-avatar-ring-width Ring thickness
--nlb-avatar-shadow Shadow under the photo
--nlb-title-color Display name colour
--nlb-title-size Display name size
--nlb-title-weight Display name weight
--nlb-title-spacing Display name letter spacing
--nlb-subtitle-color Subtitle colour
--nlb-subtitle-size Subtitle size
--nlb-subtitle-weight Subtitle weight
--nlb-bio-color Bio text colour
--nlb-bio-size Bio text size
Token What it controls
--nlb-link-bg Link background
--nlb-link-bg-hover Link background on hover
--nlb-link-text Link label colour
--nlb-link-text-hover Link label colour on hover
--nlb-link-border-color Link border colour
--nlb-link-border-color-hover Link border colour on hover
--nlb-link-border-width Link border thickness
--nlb-link-border-style Link border style (solid, dashed and so on)
--nlb-link-radius Link corner radius
--nlb-link-font-size Link label size
--nlb-link-font-weight Link label weight
--nlb-link-padding-x Horizontal padding inside links
--nlb-link-padding-y Vertical padding inside links
--nlb-link-shadow Link shadow
--nlb-link-shadow-hover Link shadow on hover
--nlb-link-transform-hover Movement on hover, for example translateY(-2px)
--nlb-link-transition Timing of hover effects
Token What it controls
--nlb-card-link-radius Corner radius of photo card links
--nlb-card-link-overlay Band colour behind photo card titles
--nlb-card-link-overlay-color Same as above (alias)
--nlb-card-link-title-color Photo card title colour
--nlb-card-link-badge-bg Icon badge background
--nlb-card-link-badge-color Icon badge colour
--nlb-media-thumb-size Thumbnail size in media links

Social icon tokens#

Token What it controls
--nlb-social-color Icon colour
--nlb-social-color-hover Icon colour on hover
--nlb-social-bg Icon button background
--nlb-social-bg-hover Icon button background on hover
--nlb-social-border-color Icon button border colour
--nlb-social-border-width Icon button border thickness
--nlb-social-radius Icon button corner radius
--nlb-social-size Icon button size
--nlb-social-icon-size Icon size inside the button
--nlb-social-transform-hover Movement on hover

Language switcher tokens#

Token What it controls
--nlb-lang-bg Language button background
--nlb-lang-bg-active Background of the current language
--nlb-lang-text-active Text colour of the current language
--nlb-lang-border Language button border colour
--nlb-lang-radius Language button corner radius

Player tokens#

The Media Player is built on Video.js 10. Two tokens style it:

Token What it controls
--nlb-player-accent Play button and progress bar colour. Defaults to --nlb-accent
--nlb-player-radius Player corner radius. Defaults to 24px

WP LinkCanvas passes these to the Video.js properties on the player element, .nlb-link__player:

Video.js property Set from
--media-accent-color --nlb-player-accent
--media-accent-text-color Black or white, whichever reads better on the accent
--media-border-radius --nlb-player-radius
--media-border-color Transparent

Video.js skins have no settings for control colours or the control bar background, so the older --nlb-player-bg, --nlb-player-btn-color and --nlb-player-text-color tokens from the Vidstack player no longer change anything. To style the player directly, set the --media-* properties on .nlb-link__player; see the Custom CSS Guide.

Overriding tokens with Custom CSS#

To change a token on one bio page, use the Custom CSS (advanced) field in the editor:

body.nlb-page {
	--nlb-link-radius: 0px;
	--nlb-accent: #e91e8c;
}

To change it on every bio page, add CSS to your theme’s stylesheet or a custom CSS plugin:

body.nlb-page {
	--nlb-card-max: 520px;
}

Values set on body.nlb-page apply to everything on the page.

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only