Use the Liquid Glass style
Liquid Glass is a second look for your help centre. The header, sidebar, cards and windows become translucent glass over soft light in your brand colour, and everything moves with fluid, Apple-style animations. Your brand colour, fonts, logo and light/dark settings all carry over, so the switch takes one click.
📷 Image placeholder: the same docs page in the Default style and in Liquid Glass, side by side.
Turn on Liquid Glass
Open the appearance settings
In your WordPress admin, go to PinkDocs → Settings and open the Appearance tab. Check that the knowledge base you want to change is selected in the PinkDocs header.
Choose the style
Under Style, click Liquid Glass.
Save and look
Click Save settings, then open your docs in a new tab. Try light and dark mode: both are designed for glass.
📷 Image placeholder: the Style section of the Appearance tab with the Default and Liquid Glass cards and the Moving background switch.
What changes
- Light behind the glass: soft fields of light in your brand colour (and lighter and deeper shades of it) drift slowly behind every page. No other colours are added.
- Glass surfaces: the header, sidebar, cards, code blocks, alerts, API panels and the Listen player become frosted glass with a bright edge.
- Liquid controls: buttons become pill shapes, the Ask AI bar becomes a floating glass capsule, and dropdowns open as glass menus in Chrome, Edge and Opera.
- Readable brand colour: badges, links and the current page use a lighter shade of your brand colour in dark mode and a deeper one in light mode, so they stay readable on glass.
📷 Image placeholder: close-up of a glass card, the floating Ask AI capsule and a brand pill button.
Animations
| Animation | What readers see |
|---|---|
| Page transitions | Moving between docs, the header and sidebar stay put while the article fades and settles in. |
| Spring motion | Buttons squish when pressed and spring back; drawers slide in like iOS sheets; windows and the search pop open. |
| Tilt and sheen | Cards tilt a little toward the pointer, with a soft highlight that follows it. |
| Ask AI capsule | The capsule grows slightly when you reach for it, like the Dynamic Island. |
| On this page | One brand-coloured bar glides along the line to the heading you're reading. |
| Scroll reveal | Cards further down the page float in as they scroll into view. |
Turn off Moving background under Style for a still background. The rest of the animations stay.
Let visitors choose
Turn on Let visitors switch style to add a Liquid Glass switch next to the light/dark switch in the docs header. The style you chose on the Appearance tab is what new visitors see; a visitor's own choice is remembered on their device.
📷 Image placeholder: the docs header with the Liquid Glass switch next to the light/dark switch.
Accessibility and browser support
- Reduced motion: visitors who ask their device for less motion get a still background and no animations.
- Reduced transparency: visitors who turn on reduced transparency get solid surfaces instead of glass.
- Older browsers: browsers without blur support show near-solid panels, so text always stays readable.
- Phones: the blur is lighter on small screens to keep scrolling smooth.
- Light bending through the glass, styled dropdown menus and page transitions use newer browser features. Where a browser doesn't support them, it shows the plain version, so nothing ever breaks.
Common questions
It adds one small stylesheet and one small script, both loaded only when the style is on. The blur is limited to a few large surfaces and is lighter on phones.
Yes. Every rule is scoped to html[data-pd-style="glass"], so you can target Liquid Glass alone with custom CSS without affecting the Default style.
Yes. All the light, tints and highlights are made from your brand colour, so the glass always matches your brand.
Their choice is remembered on their device and used on every page they visit. Visitors who never switch see the style you chose.
