Koha How-To

Add a Chat Box to your Opac for Reference Services at a Distance

This blog post will give you an idea of what Live Chat software platforms are available and how to enable them on your Koha OPAC. Shopping around for your new chat tool can be fun. Expanding your library's virtual reference repertoire can also be fun!

Library Live Chat Platforms

Let's start out with the Chat Platforms specifically tailored to libraries. You've likely heard of these before:


An Ask a Librarian software platform that unifies real-time website chat, searchable knowledge bases, email, and text messaging. It offers flexible staffing from your desktop, laptop, tablet, or smartphone. It's been around for years and allows your patrons to chat anonymously.

Springshare's LibChat

Part of the Springshare's Platform of various tools for libraries; this seems to be an option with the LibAnswers suite.

Mosio for Libraries

This is Virtual Reference Software with All-in-One Patron Support Software: Chat + Text Messaging + Email + Facebook.

Your social media platforms - use what you've got!

While not necessarily embedded in the Opac you can direct patrons to the social media platforms you already use. Encourage them to engage with your content and ask questions. Facebook, Twitter, and the like all have feeds you can add to your OPAC.

Facebook Messenger

If your library has a Facebook account/Business page why not use it to chat with your patrons? Here's a snapshot of what it looks like on ByWater's Facebook page.


Why not have your patrons Tweet their questions? You can encourage patrons to engage on Twitter like a crowd-sourced FAQ's and announcement page. There's no anonymity but great visibility; patrons can see what questions have been asked about e-resources, curbside pickup, video-storytime, virtual book clubs, and get consistent answers.

Live Chat Software/Business World Software - Why consider it?

First, Most of these chat platforms have "Free trial periods" or free "Basic" accounts that advertise taking less than 5 minutes to set up. They allow you to test drive the software without a contract or commitment. Then the paid options offer more chat agents, app integrations, reporting features, even Video live chat to help make that human connection.

Second, The software is designed for customer service and on-demand communication, but with the option to continue the conversation. Some provide inboxes/ticketing systems so if you can't find all the answers for your patron during the chat you can keep track of the request and follow up later. You can email transcripts of your reference discussion to the patron or another staff member who may have the expertise that patron needs.

Third, You can't be at the reference desk 24/7 so these chat boxes give website visitors the option to submit a question when you are away. You tell the Chat service where to email it.


Used by one of our partners and it is free. According to their website Tawk.to makes it easy to deliver personalized and real-time customer service. It Monitors traffic on your website and is there when visitors need you most. You can proactively initiate a chat with your website visitors and app users.


ByWater Solutions uses it! This chat service is available at a reasonable price. You can have one or several "Chat Agents" conducting simultaneous chats. It's designed to be convenient with response shortcuts (i.e. "Hi how can I help?" and "Curbside pickup hours are ...") and is totally browser-based. It has "Set it and forget it" reports that can be sent to you automatically if you need to track library usage stats.

Mibew Messenger

Also known as Open Web Messenger, this is an open-source live support application written in PHP and MySQL. It enables one-on-one chat assistance in real-time directly from your website.


Consistently scores highly on the "Top Live Chat" listicles. HubSpot CRM (Customer Relations Management) is "free" and comes with tools for marketing, sales, and customer service. Free live chat is part of that package. There are also paid/premium features that allow more chat agents and options.


Noted for its multilingual chat features! Customers/Patrons can see your chat widget in their preferred language based on their browser settings. Other solutions charge extra for this feature. The first Chat Agent is free and there's a monthly/annual subscription to add more agents.


This platform prioritizes voice and video chat as much as standard, text-based live chat. Speaking from experience the best reference interviews are the ones where you can be personable, see expressions, and share your screen to demo how to do something.

A brief note about Slack, Zoom, Skype, and other Chat+Video platforms.

These are really popular communication platform for teams where everyone who chats has their own account, but they are not designed for anonymous or on-demand virtual reference services, in my opinion. Some of these Live Chat Software options do integrate with Slack, Zoom, Skype, etc. and that could be a great solution for your library if you are already using these team-based tools.

Now, this is just a shortlist of the myriad Live Chat Software options available. Please go out to your favorite search engine and take a look at the top 10 or top 20 live chat options lists for yourself and choose what will best meet your library's needs and budget. Also, ask other libraries what they are using and why they like it!

Virtual Reference Services Best Practices

Choice of a Chat Software is just one small part of what's known as Virtual Reference Services. What need or problem does adding a Chat Box to your Public Catalog or Website solve? What Problems does it create? Who staffs the Chat program and when?

I recommend taking a look at ALA and PLA's resources on Virtual Reference. They're a bit vintage (shout out to AOL instant messenger!) but the core ideas have not yet gone the way of the Dodo bird.

Virtual Reference Selected Annotated Bibliography

ALA Wiki on Virtual Reference

PLA Resources on Virtual Reference

RUSA Guidelines for Implementing and Maintaining Virtual Reference Services

How to implement it in Koha!

Once you have your chat platform picked out it's time to add it to Koha. You need to decide if you want the Chat Box to appear on every page of the Opac or just the initial front page of the Opac. This will determine where you put the code that makes the Chat Box appear.

Only on the Front Page

The chatbox works by either providing you with a brief snippet of code that you add as HTML/Javascript to your website or by integrating directly with your CMS (Content Management System). In this case you'll be using the first option to add that snippet to the News Block section OpacNavRight. Go to HomeToolsNews › and Add news item. Select the OpacNavRight (en) location from the dropdown menu. If you have additional languages installed on Koha do this for those languages as well. You'll give the news item a title and publication date. Ignore the expiration date (unless you already know what day you'll discontinue using the chat service.)

Next you will add your code snippet. This code will be given to you as part of the set up process with whichever chat platform you choose. Have your chat platform settings open in another tab to quickly copy this snippet over to Koha. It will look something like this:

<!-- begin chatbox code -->
<script type="text/javascript" async> ;
(function(c,h,a,t,b,o,x){if(o.chatbox)return; r="script";y=l.createElement(r);r=l.getElementsByTagName(r)[0];
y.async=1;y.src="//"+a;r.parentNode.insertBefore(y,r); y=o.chat=function(){k.s.push(arguments); y.extend=function(i,j){y("extend",i,j)}; y.identify=function(i){y("identify",k.i=i)}; y.configure=function(i,j){y("configure",i,j);k.c[i]=j}; })(window,document,"static.chatbox.com/jsclient/loader.js");
/* custom configuration goes here (www.chatbox.com/documentation) */
<!-- end chatbox code -->

In Koha's News: editor go to Tools and select < > Source code from the menu. This will allow you to paste in the code snippet.

Save the Source code and hit Submit to save your news item. Now when you reload the Opac the chatbox will appear. I suggest checking out the examples provided by the chat services, or visiting other partners' Opacs to get a true to life example of how the chat box will perform.

On EVERY page

If you want the chat box to available on every page of the Opac you'll add the code snippet to the Opac Credits system preference. The steps are the same, just in a different section of Koha Administration. (Side note: Bug 23795 - Converts OpacCredits system preference to news block.)

Go to HomeAdministrationSystem preferences and pull up the system preference opaccredits. Opac credits appear on every page of the Opac, wherever the patron goes, so the chat will be available to them everywhere. Click to edit the system preference, paste in the code, and save your changes.

Now when you reload the Opac the chatbox will appear. Again, I suggest checking out the examples provided by the chat services, or visiting other Partners' Opacs to get a true to life example of how the chat box will perform.

Finally, if you have any questions about these steps or want help adding a live chat box to your Koha Opac just contact ByWater Support. We're here to help!