Custom CSS Guide
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.

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
Link classes#
| 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#
Square links#
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;
}
Style one link#
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;
}
Show the embed caption link#
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.