Step 1. Get your MyLiveChat code
Sign in to the MyLiveChat web console and click
Deployment menu on the left. Choose Chat Button tab and copy the MyLiveChat
code. It is a single script tag and it is the same code on every platform.
Step 2. Add the code as a Custom module
- In the Joomla administrator, open Content » Site Modules (Joomla 4 and 5) or Extensions » Modules (Joomla 3), then click New.
- Choose the Custom module type.
- Switch the editor to code view with the Toggle Editor / <> Source button, then paste the MyLiveChat code.
- Set Position to a footer position in your template, set Status to Published, and under Menu Assignment choose On all pages.
- Save & Close. Paste the code once - two modules produce two chat launchers.
Check that live chat is working
Save the code, then open your site in a private browsing window. A private window matters: as a signed-in
administrator you may see a different version of the page than your visitors do.
- Look for the chat launcher on the page. If it is missing, view the page source and
search for mylivechat to confirm the code is really being served.
- Start a chat as a visitor and send a test message.
- Sign in to the web console and confirm the message arrives
and that you can reply.
- Close the chat and check the transcript is saved, so you know follow-up will work.
If your site caches pages, clear the cache before deciding something is broken. A cached
copy of the old page is the single most common reason a correct installation looks like a
failed one.
Common Joomla setup mistakes
- The module is installed but not published. A Joomla module does nothing until it is published and assigned to a menu item. Assign it to All pages so chat is available everywhere.
- It is assigned to one menu item. Check the Menu Assignment tab if chat appears on the home page only.
- Chat looks offline to everyone. The widget shows an offline form when no
agent is signed in. That is working as intended - set your hours and your offline
message so the page tells visitors when to expect a reply.
Make the chat window fit your site
Colours, position, language and the pre-chat form are all set in your MyLiveChat
dashboard, not in the Joomla code, so you can change them without touching your site again.
See customization options for what can be
changed, and visitor monitoring if you want to
see which page a visitor is on before you reply.
Related guides
New to live chat? Start with
how to add live chat to your
website and the
live chat launch checklist.
Also useful: Where to place the chat widget.
Also useful: Live chat best practices.
If you are worried about page speed, see
does live chat slow down your
website.
What's next?
After setup, sign in to the web console to answer visitors from your browser. You can also use the desktop app from the download page if your team prefers it.
Joomla live chat FAQ
Do I need the module, or can I just embed the code?
Either works. The module is easier to manage from the Joomla admin; the embedded code is the simpler option if you already edit your template.
Which pages will show chat?
That depends on the module's menu assignment. Assign it to all pages unless you deliberately want chat on a subset.
Will it slow down my site?
The chat code loads asynchronously, so it does not block your page from rendering. If you want to check that for yourself rather than take our word for it, measure your own pages before and after with your usual speed tool.
Is it really free?
Yes. One agent, unlimited chats and unlimited websites are free forever, with no credit card required.
Any questions?
If anything is unclear, contact our support team from the chat button on this page or visit the Support page. We can help you choose the right setup path.