How to Configure Branding in Koha Theme Builder™

Step-by-step branding guide for Koha Theme Builder™ covering logos, colors, typography choices, and accessibility checks.

This guide shows you how to apply your library brand in Koha Theme Builder™.

What this element controls

Brand identity settings: logo, color palette, typography options, and reusable visual style tokens.

Where patrons see it

Across all themed OPAC screens, including homepage, search results, bibliographic detail, and account pages.

Why this matters

Consistent branding improves trust, recognizability, and readability while reducing one-off visual fixes.

Before you start

  • Logo files (SVG preferred; PNG fallback)
  • Brand color values (hex)
  • Typography guidance (if your institution has it)
  • Accessibility baseline (contrast expectations)

Step-by-step

  1. Open Theme Builder.
  2. Go to Branding settings.
  3. Upload primary logo and fallback variant if available.
  4. Set primary and secondary brand colors.
  5. Configure accent and neutral values (if supported).
  6. Apply typography options.
  7. Preview headers, buttons, links, and body text.
  8. Run accessibility checks for contrast.
  9. Save draft and request review.
  10. Publish when approved.

Before you publish Validate contrast on buttons, links, and text over image backgrounds. Brand compliance should never reduce legibility.

Logo and file recommendations

  • Use SVG when available
  • Keep transparent background variants
  • Keep dimensions consistent across header and mobile views
  • Avoid very small logos that lose detail in mobile navigation

Common mistakes

  • Using non-brand color values ad hoc
  • Choosing low-contrast accent colors
  • Stretching logo images beyond natural proportions
  • Skipping checks on bib detail and account pages

Branding visuals

Branding output example (Cloister homepage)

Branding output example (Chambers homepage)

Branding consistency target (Cloister bibliographic detail)

Next Steps

More in Koha System

Was this article helpful?

Thanks for your feedback!