Keep Koha visitors engaged with videos

Learn how to embed a YouTube video on the Koha OPAC (Online Public Access Catalogue).

Video can be a powerful tool for telling stories and connecting with communities. In 2024, New Zealanders spent an average of 7 hours per week consuming online content, with video content being the most popular format. Libraries are creating useful video content for their communities, such as library guides, “how-tos”, interviews with librarians, authors or even students. Did you know that you can easily include these resources in your Koha? Aleisha Amohia, Rōpū kohinga Technical Lead, shares how to embed a YouTube video on the Koha online public interface (OPAC).

How to embed a YouTube video in Koha

Please note, YouTube is used as an example throughout the blog post, but the steps are similar for embedded code from other video platforms.

If you'd like to try out adding a YouTube video to Koha online, check out our demo site as you read along.

1. Go to your YouTube video and click the Share button (circled in blue).

The landing page of the 'Koha upgrade highlights and catalogue customisations tip

2. In the Share pop-up window, click the Embed button (circled in blue).

The results from clicking on the Share button on YouTube. The option to embed is circled in blue

3. This will open a window with some code. Click the Copy button (circled in blue).

The landing page of the 'Koha upgrade highlights and catalogue customisations tips webinar next to the embed video option

4. Log in to your Koha staff interface, then go to the Tools module. Under the Additional tools list, go to HTML customisations. You can either edit an existing entry or make a new one. Make sure you choose to use the text editor so you can easily paste the embed code.

5. Paste the Embed code directly in the Content box. Ensure the other details are correct, then hit the Save button. Make sure you include the:

  • Display location: Choose an area on your OPAC for your video to show, such as the OpacMainUserBlock.
  • Title: This does not show on the OPAC, but should describe what the HTML customisation contains so you can differentiate it from any others.

Bonus tip: You can schedule your video in advance by selecting your preferred publish date. Otherwise, your video will upload on today’s date.

New HTML customization screen on Koha

6. Enjoy the newly embedded video on your Koha public interface!

Optionally, you can return to the HTML customisations editor in the staff interface to add content around the video.

  • If you’re comfortable writing in HTML, use the text editor.
  • To use formatting buttons without touching the code, use the WYSIWYG editor. For example, you may choose to add a heading and some introduction text to your OPAC.

YouTube video published on the Koha OPAC

Learn more Koha tips and tricks

There are lots of ways to customise your Koha without touching the code. 

If you’d like to learn more about the flexibility of Koha and how you get more out of your library system, Rōpū kohinga is happy to help. Contact us to discuss training options for you and your team.

We also run Koha webinars throughout the year. If there’s any content you’d like us to cover, get in touch.

Return to Catalyst blog

Learn more about Koha

A bookshelf fulled with books extends off into the distance as a collection of light bulbs hand

How to do a stocktake with Koha

Keeping your Koha catalogue up to date with what’s actually on the shelves is easy using the dedicated Inventory tool. There are several different ways of using the tool.