---
title: "Custom CSS"
url: "/help/buuk/custom-css"
updated: "2026-10-22T11:13:38.198Z"
---
# Custom CSS

Custom CSS is for the last few pixels: a heading that sits too tight, a code block that wants a little more breathing room. It is not the place to restyle the help center — brand color, logo, layout, and homepage copy have their own settings in [Branding](./branding-and-custom-domain) and cover most of what a help center needs.

## How it is applied

Buuk stores custom CSS as a workspace setting and injects the sanitized result into a `<style>` tag on the public help center, so your tweaks ship with every page.

Before injection the CSS is sanitized: angle brackets are stripped, `@import` rules are removed, and known-dangerous tokens such as `javascript:` and `expression(` are dropped. Long stylesheets are truncated, so keep the stylesheet small.

## A tasteful example

```css
/* Tighten heading rhythm and readjust line length on long paragraphs */
.help-center h1 { margin-top: 2.5rem; }
.help-center h2 { margin-top: 2rem; }

.help-center p {
  line-height: 1.7;
  max-width: 68ch;
}
```

Small, additive and reversible is the bar. Prefer styles that survive minor theme changes — spacing and line lengths age well; hard-coded colors and font swaps do not.

> [!WARNING]
> CSS is unsupported surface area: if a tweak breaks a layout after an update, it is the CSS, not the theme. Prefer the branding settings first — logos, brand color, and the layout picker — and keep custom CSS to residual spacing and type tweaks.

## Related

- [**Branding**](./branding-and-custom-domain) — do this first; CSS is for the rest.
- [**Docs homepage**](./docs-homepage) — homepage copy and the layout picker.
- [**Header links and navigation**](./header-links-and-navigation) — header and footer links.
- [**Publish your help center**](./publish-your-help-center) — what readers see once saved.