Koha System

How to Create and Style Custom Pages in Koha Theme Builder™

Step-by-step guide to creating and styling custom pages in Koha Theme Builder™, adding blocks, linking navigation, and keeping visual consistency.

2 min read

This guide shows you how to create and style custom OPAC pages in Theme Builder.

What this element controls

Custom page templates/sections (where supported), content block composition, and page-level presentation consistency.

Where patrons see it

Standalone informational pages linked from OPAC navigation (hours, policies, services, events, branch pages).

Why this matters

Custom pages are often high-traffic policy and service pages. Consistent design improves trust and readability.

Before you start

  • Confirm page purpose and audience
  • Prepare approved content and links
  • Decide where page appears in navigation

Step-by-step

  1. Open Theme Builder.
  2. Go to Custom Pages or Content Pages section.
  3. Create a new page.
  4. Select page layout/template.
  5. Add content sections/blocks.
  6. Apply branding-consistent styles.
  7. Add the page to navigation.
  8. Preview desktop and mobile.
  9. Save draft and request review.
  10. Publish and verify links.

Good to know If your environment has limits on custom page templates, use supported block patterns and keep structure consistent with your selected preset.

Common mistakes

  • Publishing pages that are not linked from navigation
  • Mixing multiple visual styles in one page
  • Copy-pasting legacy inline CSS that conflicts with Theme Builder

Next Steps

After Deployment
Post-Installation Setup
Recommended
Security Best Practices
Keep It Running
Monitoring & Maintenance

More in Koha System

Was this article helpful?

Thanks for your feedback!