Customization

Adding Custom CSS

May 4, 2026 docsadmin 1 min read

When the Customizer doesn’t go far enough, custom CSS picks up. Here’s how to add it without breaking updates.

MyWiki uses CSS custom properties (variables) for every color, font, and spacing token. That makes targeted overrides clean and update-safe.

Use the Customizer

The simplest path for small tweaks: Appearance u2192 Customize u2192 Additional CSS. Anything you write here is stored in your database, survives theme updates, and applies site-wide.

/* Make article body text larger */
.mw-article {
    font-size: 1.1rem;
    line-height: 1.85;
}

Override a CSS variable

MyWiki’s variables are defined on :root. Override them globally:

:root {
    --mw-accent: #2563eb;        /* swap to a blue accent */
    --mw-bg: #ffffff;            /* pure white background */
    --mw-text: #18181b;          /* slightly different ink */
}

Common variables

  • --mw-bg, --mw-bg-card, --mw-bg-soft u2014 backgrounds
  • --mw-text, --mw-text-muted u2014 typography
  • --mw-accent u2014 the highlight color (links, italics, focus rings)
  • --mw-border, --mw-border-soft u2014 divider lines
  • --mw-serif, --mw-sans, --mw-mono u2014 font stacks

When to use a child theme instead

If you’re adding 20+ lines of CSS or modifying templates, build a child theme. The next article walks through that.

Leave a comment