OPAC search and menu toggles may fail to load on custom themes
Custom themes may fail to load essential JavaScript files, breaking search and menu toggles.
- Published
- May 28, 2026
- Last Updated
- May 28, 2026
- Affected Versions
- Koha AMI builds released before this patch
- Fixed In
- Pending AMI release
Overview
Customers using custom themes in their Koha OPAC may experience issues with the search bar and mobile menu toggles not functioning correctly. This is due to missing or incorrectly loaded JavaScript files in certain themes. The problem arises when the Asset.js plugin fails to resolve paths to the current theme’s JavaScript directory, resulting in silent failures where no script is loaded. This advisory addresses these regressions by hardcoding the paths to essential JavaScript files and ensuring they are correctly loaded in all themes.
Affected Versions
- Koha AMI builds released before this patch.
Remediation
Option 1: Upgrade to Patched AMI
When a patched AMI is available on AWS Marketplace, launch a new instance from it and migrate your data. See the migration guide for step-by-step instructions.
Option 2: Apply Interim Mitigation
No interim mitigation is available. Upgrade to the patched AMI when released.
Option 3: Contact Support
If you are unsure how to apply the above steps, contact us at [email protected] or use the contact form. We can walk you through the fix remotely.
Timeline
| Date | Event |
|---|---|
| 2026-05-28 | Issue identified |
| 2026-05-28 | Advisory published |
| — | Patched AMI target (TBD) |