CSS Token Reference
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 |
Link tokens#
| 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 |
Photo card and media link tokens#
| 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.