Docs

Custom CSS Guide

3 min readUpdated November 10, 2026

Style bio pages with your own CSS, either for one page or for all of them.

Where to add CSS#

One bio page: in the editor, expand Custom CSS (advanced) at the bottom. The CSS is printed on that bio page only, after the theme’s styles. Write full selectors starting with body.nlb-page; the CSS is not rewritten or scoped for you.

The Custom CSS box for one bio page

All bio pages: add CSS to your theme, child theme or a custom CSS plugin, starting selectors with body.nlb-page.

The built-in Link Bio → Design Guide has more recipes.

Page structure#

body.nlb-page (.nlb-rtl on right-to-left pages)
  .nlb-gate                    ← page-level sensitive gate (when on)
  .nlb-card                    ← the card holding everything
    .nlb-avatar                ← profile photo
    .nlb-title                 ← display name
    .nlb-subtitle              ← subtitle
    .nlb-bio                   ← bio text
    .nlb-socials               ← social icon row
      .nlb-social              ← one social icon
    .nlb-showcase              ← product rail (above the links)
    .nlb-links                 ← the links
      .nlb-link                ← one link
    .nlb-showcase              ← product rail (below the links)
    .nlb-lang-switcher         ← links to the other languages
      .nlb-lang
  .nlb-qr-section              ← desktop QR code
  .nlb-link-gate               ← per-link sensitive confirmation
Class Link
.nlb-link Every link
.nlb-link--card Enhanced Link (photo card)
.nlb-link--media Media (square thumbnail)
.nlb-link--embed Embed
.nlb-link--embed-{provider} A specific embed, such as .nlb-link--embed-youtube
.nlb-link--shortcode Shortcode
.nlb-link--player Media player
.nlb-link--player-video / .nlb-link--player-audio Video or audio player
.nlb-link--countdown Countdown timer
.nlb-link--featured Any featured link

The older classes .nlb-link--vidstack, .nlb-link--vidstack-video and .nlb-link--vidstack-audio are still on player links, so CSS written for earlier versions keeps working.

Each link also has data-nlb-slot with its own ID, for styling one link.

Recipes#

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

A different accent colour#

body.nlb-page {
	--nlb-accent: #e91e8c;
}

A wider page#

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

Hide the profile photo#

body.nlb-page .nlb-avatar {
	display: none;
}

Find the link’s data-nlb-slot value with your browser’s inspector:

body.nlb-page .nlb-link[data-nlb-slot="l_book"] {
	background: #ff6a00;
}

Bigger social icons#

body.nlb-page {
	--nlb-social-size: 48px;
	--nlb-social-icon-size: 22px;
}

Media player accent and corners#

body.nlb-page .nlb-link__player {
	--media-accent-color: #ff6a00;
	--media-border-radius: 12px;
}

.nlb-link__player is the player element inside the link. Video.js reads these --media-* properties; the theme sets them on the same element, and per-page Custom CSS comes after the theme, so yours win.

Taller photo cards#

body.nlb-page .nlb-link--card {
	min-height: 220px;
}

Bigger countdown numbers#

body.nlb-page .nlb-countdown__num {
	font-size: 40px;
}
body.nlb-page .nlb-link__embed-caption {
	display: block;
}

Right-to-left pages#

Right-to-left pages have body.nlb-page.nlb-rtl and dir="rtl". Layout uses logical properties, so most things flip on their own. For language-specific fonts:

body.nlb-page.nlb-rtl .nlb-title {
	font-family: "Cairo", sans-serif;
}

Using tokens#

Theme tokens are available in your own rules:

body.nlb-page .my-element {
	color: var(--nlb-accent);
	background: var(--nlb-link-bg);
	border-radius: var(--nlb-link-radius);
}

See the CSS Token Reference.

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