How to Configure Branch-Specific Appearance in Koha Theme Builder™

This guide shows you how to use global theme settings and branch-specific overrides safely in Theme Builder.

What this element controls

Which visual settings remain global and which can vary by branch.

Where patrons see it

Across OPAC screens when branch context is active.

Why this matters

Branch flexibility is useful, but uncontrolled differences can confuse patrons and weaken brand consistency.

Before you start

• Define non-negotiable global brand rules
• Identify branch-specific needs (hours, announcements, spotlight content)
• Confirm branch-level edit permissions

Step-by-step

1. Open Theme Builder.
2. Set global baseline family, preset, and branding.
3. Enable branch override scope (if available in your environment).
4. Apply minimal branch-specific overrides first.
5. Preview branch A and branch B side by side.
6. Verify navigation and account consistency.
7. Save draft, review with branch owners.
8. Publish in controlled phases.

For multi-branch libraries Launch with one global baseline and only essential branch overrides. Expand gradually after consistency checks.

Common mistakes

• Allowing branch overrides for core brand tokens too early
• Applying many branch differences before baseline QA
• Forgetting to test search and account pages per branch

Related guides

• How to Configure Navigation in Theme Builder
• Theme Builder Permissions and Roles
• Theme Builder Settings Reference